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NumPy 一 一 快速 处 理 数据 
SymPy 一 一 符号 运算 好 帮手 
Traits 一 一 为 Python 添加 类 型 定义 
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内 容 简 介 


本 书 介 绍 如 何 用 Python 开发 科学 计算 的 应 用 程序 ， 除 了 介绍 数值 计算 之 外 ， 还 着 重 介绍 如 何 制作 交 
互 式 的 2D、3D 图 像 , 如 何 设计 精巧 的 程序 界面 , 如 何 与 C 语言 编写 的 高 速 计算 程序 结合 , 如 何 编写 声音 、 
图 像 处 理 算法 等 内 容 。 书 中 涉及 的 Python 扩展 库 包 括 NumPy、 SciPy、 SymPy、 matplotlib、Traits、TraitsUI、 
Chaco、TVTK、Mayavi、VPython、OpenCV 等 ， 涉 及 的 应 用 领域 包括 数值 运算 、 符 号 运算 、 二 维 图 表 、 
三 维 数据 可 视 化 、 三 维 动画 演示 、 图 像 处 理 以 及 界面 设计 等 。 

书 中 以 大 量 实例 引导 读者 逐步 深入 学 习 , 每 个 实例 程序 都 有 详尽 的 解释 ， 并 都 能 在 本 书 推荐 的 运行 环 
境 中 正常 运行 。 此 外 ， 本 书 附 有 大 量 的 图 表 和 插图 ， 力 求 减少 长 篇 的 理论 介绍 和 公式 推导 ， 以 便 读者 通过 
实例 和 数据 学 习 并 掌握 理论 知识 。 
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Preface 


Python is rightfully viewed as a general purpose language，well suited for web development, 
system administration, and general purpose business applications. It’s has earned this reputation well 
by powering web sites such as YouTube, installation tools integral to Red Hat’s operating system, and 
large corporate IT systems from cloud cluster management to investment banking. Python has also 
established itself firmly in the world of scientific computing covering a wide range of applications 
from seismic processing for oil exploration to quantum physics. This breadth of applicability is 
significant because these seemingly disparate uses often overlap in important ways. Applications that 
can easily connect to databases publish information to the web, and efficiently carry out complex 
calculations are now critical in many industries. Python’s primary strength is that it allows developers 
to build such tools quickly. 

Python’s scientific computing roots actually go quite deep. Guido van Rossum created the 
language while at CWI, the Center for Mathematics and Computer Science, in the Netherlands. As 
interest developed outside the center, others began to contribute. The first several Python workshops, 
starting in 1994, were held an ocean away at scientific institutions such as NIST (National Institute of 
Instruments and Technology), the US Geological Society, and LLNL (Lawrence Livermore National 
Laboratories), all science centric institutions. At the time, Python 1.0 had recently been released and 
the attendees were just beginning to hammer out the design of its mathematical tools. A decade and a 
half later, it is gratifying to see how far we have come both in the amazing capabilities of the tool set 
and the diversity of the community. It is somehow fitting that the first comprehensive book (that I 
know of) covering the primary scientific computing tools for Python is composed and published, 
another ocean away, in Chinese. Looking forward a decade and a half, I can hardly wait to see what 
we will all build together. 

Guido, himself, was not a scientist or engineer. He sat squarely in the computer science branch of 
CWI and created Python to ease the pain of building system administration tools for the Amoeba 
operating system. At the time, the tools were being written in C. Python was to be the tool that 
“bridged the gap between shell scripting and C.” Operating system tools are not even in the same 
neighborhood as matrix inversions or fast Fourier transforms, but, as the language emerged, scientists 
around the world were some of its earliest adopters. Guido had succeeded in creating an elegantly 
expressive language that coupled nicely with their existing C and Fortran code. And, in Guido, they 
had a language designer willing to listen and add critical features, such as complex numbers, 
specifically for the scientific community. With the creation of Numeric, the precursor to NumPy, 
Python gained a fast and powerful number crunching tool that solidified Python’s role as a leading 


computational language in the coming decades. 


soejeid 


For some, the term "scientific programming”conjures up visions of intricate algorithms described 
from “Numerical Recipes in C” or forged in late night programming sessions by graduate students. 
But the reality is the domain encompasses a much wider range of programming tasks from low level 
algorithms to GUI development with advanced graphics. This latter topic is too often underestimated 
in terms of importance and effort. Fortunately, Ruoyu Zhang has done us the service of covering all 
facets of the scientific programming in this book. Beginning with the foundational Numpy library the 
algorithmic toolboxes in SciPy he provides the fundamental tools for any scientific application. He 
then aptly covers the 2D plotting and 3D visualization libraries provided by matplotlib, chaco, and 
mayavi. Application and GUI development with Traits and Traits UL and coupling to legacy C 
libraries through Cython, Weave, ctypes, and SWIG are well covered as well. These core tools are 
rounded out by coverage of symbolic mathematics with SymPy and various other useful topics. 

It’s tmly gratifying to see all of these topics aggregated into a single volume. It provides a 
one-stop shop that can lead you from the beginning steps to a polished and full featured application for 
analysis and simulation. 


Eric Jones 
2011/12/8 


Python 理所当然 地 被 视 为 一 门 通用 的 程序 设计 语言 ， 非常 适合 于 网 站 开发 、 系 统管 理 以 及 
通用 的 业务 应 用 程序 。 它 为 诸如 YouTube 这 样 的 网 站 系统 、Red Hat 操作 系统 中 不 可 或 缺 的 
安装 工具 以 及 从 云 管理 到 投资 银行 等 大 型 企业 的 IT 系统 提供 技术 支持 ， 从 而 赢得 了 如 此 高 的 
声誉 。Python 还 在 科学 计算 领域 建立 了 牢固 的 基础 ， 覆 盖 了 从 石油 勘探 的 地 震 数据 处 理 到 量子 
物理 等 范围 广泛 的 应 用 场景 。Python 这 种 广泛 的 适用 性 在 于 ， 这 些 看 似 不 同 的 应 用 领域 通常 在 
某 些 重要 的 方面 是 重 登 的 。 易 于 与 数据 库 连 接 、 在 网 络 上 发 布 信息 并 高 效 地 进行 复杂 计算 的 应 
用 程序 对 于 许多 行业 是 至 关 重 要 的 , 而 Python 最 主要 的 长 处 就 在 于 它 能 让 开发 者 迅速 地 创建 这 
样 的 工具 。 

实际 上 ，Python 与 科学 计算 的 关系 源远流长 。 吉 多 “。 范 罗 苏 姆 创建 这 门 语言 ， 还 是 在 他 在 
荷兰 阿姆斯特丹 的 国家 数学 和 计算 机 科学 研究 学 会 (CCWD 的 时 候 。 当 时 只 是 作为 “课余 ”的 开 
发 ， 但 是 很 快 其 他 人 也 开始 为 之 做 出 贡献 。 从 1994 年 开始 的 头 几 次 Python 研讨 会 ， 都 是 在 大 
洋 彼 岸 的 科研 机 构 举行 的 。 例 如 国家 标准 技术 研究 所 (NIST)、 美 国 地 质 学 会 以 及 劳伦斯 利 福 摩 
尔 国家 实验 室 (LLNL)， 所 有 这 些 都 是 以 科研 为 中 心 的 机 构 。 当 时 Python 1.0 刚刚 发 布 ， 与 会 者 
们 就 已 经 开始 打造 Python 的 数学 计算 工具 。10 多 年 过 去 了 ， 我 们 欣喜 地 看 到 ， 我 们 在 开发 具 
有 惊人 能 力 的 工具 集 以 及 建设 多 彩 的 社区 方面 做 出 了 如 此 多 的 成 绩 。 很 合 时 宜 的 是 ， 就 我 所 知 
的 第 一 本 涵盖 了 Python 的 主要 科学 计算 工具 的 综合 性 著作 , 在 另 一 个 海洋 之 遥 的 中 国 编著 并 出 
版 了 。 展 望 今后 的 十 几 年 ， 我 迫不及待 地 想 看 到 我 们 能 共同 创建 出 怎样 的 未 来 。 

吉 多 他 本 人 并 不 是 科学 家 或 工程 师 。 他 在 CWI 的 计算 机 科学 部 门 时 ， 为 了 缓解 为 阿 米 巴 
(Amoeba) 操 作 系统 创建 系统 管理 工具 的 痛苦 ， 他 创建 了 Python。 当 时 那些 系统 管理 工具 都 是 用 
C 语言 编写 的 。 于 是 Python 就 成 了 填补 shell 脚本 和 C 语言 之 问 空白 的 工具 。 操 作 系统 工具 与 
计算 逆 矩 阵 或 快速 傅立叶 变换 是 完全 不 同 的 领域 , 但 是 从 Python 诞生 开始 , 世界 各 地 的 许多 科 
学 家 就 成 了 它 最 早期 的 采用 者 。 吉 多 成 功 地 创建 了 一 门 能 与 他 们 的 C 和 Fortran 代码 完美 结合 
的 、 具 有 优雅 表现 力 的 程序 语言 。 并 且 ， 吉 多 是 一 位 愿意 听取 建议 并 添加 关键 功能 的 语言 设计 
师 , 例如 支持 复数 就 是 专门 针对 科学 领域 的 。 随 着 NumpPy 的 前 身 一 一 Numeric 的 诞生 ，Python 
获得 了 一 个 高 效 且 强大 的 数值 运算 工具 ， 它 巩固 了 在 未 来 几 十 年 中 ，Python 作为 领先 的 科学 计 
算 语 言 的 地 位 。 

对 于 一 些 人 来 说 ，“ 科 学 计算 编程 ” 会 让 人 联想 起 Numerical Recipes in C 中 描述 的 那些 复 
杂 算法 ,或 是 研究 生 们 在 深夜 中 努力 打造 程序 的 场景 。 但 是 真实 情况 所 涵盖 的 范围 更 广泛 一 一 
从 底层 的 算法 设计 到 具有 高 级 绘图 功能 的 用 户 界面 开发 。 而 后 者 的 重要 性 却 常常 被 忽视 了 。 幸 
运 的 是 在 本 书 中 ， 作 者 为 我 们 介绍 了 科学 计算 编程 所 需 的 各 个 方面 。 从 NumPy 库 和 SciPy 算 
法 工具 库 的 基础 开始 ， 介 绍 了 任何 科学 计算 应 用 程序 所 需 的 基本 工具 。 然 后 ， 本 书 很 恰当 地 介 
绍 了 二 维 绘图 以 及 三 维 可 视 化 库 一 一 matplotlib、Chaco、Mayavi。 用 Traits 和 TraitsUI 进行 应 
用 程序 和 界面 开发 ， 以 及 用 Cython、Weave、ctypes 和 SWIG 等 与 传统 的 C 语言 库 相 互 结合 等 


内 容 在 书 中 也 有 很 好 的 介绍 。 除 了 这 些 核心 的 工具 之 外 ， 本 书 还 介绍 了 使 用 SymPy 进行 数学 
符号 运算 以 及 其 他 的 各 种 有 用 的 主题 。 

所 有 这 些 主题 都 被 汇编 到 一 本 书 中 真是 一 件 令 人 欣喜 的 事情 。 本 书 所 提供 的 一 站 式 服务 ， 
能 够 指导 读者 从 最 初 的 入 门 直到 创建 一 个 漂亮 的 、 全 功能 的 分 析 与 模拟 应 用 程序 。 


Eric Jones 
2011 年 12 月 8 日 
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Eric Jones 是 Enthought 公司 的 CEO， 他 在 工程 和 软件 开发 领域 拥有 广泛 的 背景 ， 指 导 
Enthought 公司 的 产品 工程 和 软件 设计 。 在 共同 创建 Enthought 公司 之 前 ， 他 在 杜 克 大 学 电机 工 
程 学 系 从 事 数值 电磁 学 以 及 遗传 优化 算法 方面 的 研究 ， 并 获得 了 该 系 的 硕士 和 博士 学 位 。 他 教 
授 过 许多 用 Python 做 科学 计算 的 课程 ， 并 且 是 Python 软件 基金 会 的 成 员 。 


关于 Enthought 公司 


Enthought 是 一 家 位 于 美国 得 克 萨 斯 州 首府 奥斯汀 的 软件 公司 ， 主 要 使 用 Python 从 事 科 学 
计算 工具 的 开发 。 本 书 中 介绍 的 NumPy、SciPy、Traits、TraitsUI、Chaco、TVTK 以 及 Mayavi 
均 为 该 公司 开发 或 维护 的 开源 程序 库 。 


Python 是 一 种 面向 对 象 的 、 动 态 的 程序 设计 语言 ， 具 有 非常 简洁 而 清晰 的 语法 ， 既 可 以 用 
于 快速 开发 程序 脚本 ， 也 可 以 用 于 开发 大 规模 的 软件 ， 特 别 适合 于 完成 各 种 高 层 任务 。 

随 着 NumPy、SciPy、matplotib、ETS? 等 众多 程序 库 的 开发 ，Python 越 来 越 适 合 于 做 科学 
计算 。 与 科学 计算 领域 最 流行 的 商业 软件 MATLAB 相 比 ，Python 是 一 门 真正 的 通用 程序 设计 
语言 ， 比 MATLAB 所 采用 的 脚本 语言 的 应 用 范围 更 广泛 ， 有 更 多 程序 库 的 支持 ， 适 用 于 
Windows 和 Linux 等 多 种 平台 ， 完 全 免费 并 且 开放 源码 。 虽 然 MATLAB 中 的 某 些 高 级 功能 目 
前 还 无 法 替代 ， 但 是 对 于 基础 性 、 前 瞻 性 的 科研 工作 和 应 用 系统 的 开发 ， 完 全 可 以 用 Python 
来 完成 。 

本 书 介 绍 如 何 用 Python 开发 科学 计算 的 应 用 程序 ， 除 了 介绍 数值 计算 之 外 ， 还 着 重 介绍 
了 如 何 制作 交互 式 二 维 、 三 维 图 像 ， 如 何 设计 精巧 的 程序 界面 ， 如 何 与 C 语言 编写 的 高 速 计 算 
程序 结合 ， 如 何 编写 声音 、 图 像 处 理 算法 等 内 容 。 

由 于 Python 的 相关 资源 非常 多 ， 本 书 不 可 能 全 部 涉及 ， 相 信 读 者 在 掌握 本 书 所 介绍 的 一 
些 相关 知识 之 后 , 只 要 充分 利用 互联 网 的 搜索 功能 , 就 一 定 能 够 很 快 地 找到 合适 的 Python 解决 
方案 。 此 外 ,由 于 绝 大 多 数 Python 资源 都 开放 源 代 码 ， 因 此 读者 将 会 很 容易 地 对 感 兴趣 的 内 容 
进行 深度 控 气 和 研究 。 

本 书 适合 于 工科 高 年 级 本 科 生 、 研 究 生 、 工 程 技术 人 员 以 及 计算 机 开发 人 员 阅读 。 实 例 篇 
以 信号 处 理 为 主 ， 通 过 简单 易 懂 的 Python 源 程序 ， 实 际 演示 信号 处 理 的 一 些 基础 知识 和 原理 ， 
因此 特别 适合 于 相关 专业 的 学 生 作为 扩展 视野 的 补充 阅读 教材 。 

阅读 本 书 的 读者 需要 掌握 Python 语言 的 一 些 基础 知识 ， 下 面 是 一 个 “自我 检测 列表 ”， 
如 果 读 者 熟悉 下 述 内 容 , 阅读 本 书 的 实例 源 代码 就 应 该 没有 困难 。 此 外 由 于 Python 程序 简单 易 
读 ， 即 使 读者 没有 接触 过 Python， 也 可 以 边 阅读 本 书 边 通过 其 他 书籍 或 免费 教程 学 习 Python。 

。 基本 语法 ; 库 的 载 入 imporD)、 循 环 (for、whilej、 判 断 GD、 函 数 定义 (deg) 

。 基本 数据 类 型 的 用 法 :列表 (list)、 字 典 (dict)、 元 组 (tuple)、 字 符 串 

。 面向 对 象 的 基本 语法 .类 (class)、 继 承 

。 C 语言 编程 的 基础 知识 2 

有 关 Python 语言 的 基础 知识 ， 可 以 参考 吸 木 鸟 社 区 的 Python 图 书简 介 。 


» http://wiki.woodpecker.org.cn/moin/PyBooks 
叹 木 鸟 社区 的 Python 图 书 概览 


本 书 所 有 演示 程序 ， 均 在 Windows XP 系统 下 采用 Python(x.y) 通 过 测试 。 如 果 读 者 觉得 安 
装 众多 的 Python 程序 库 很 麻烦 ， 不 妨 下 载 安装 Python(x.y)， 或 者 直接 使 用 本 书 所 附 光 盘 中 的 
Python(x,y) 安 装 程序 。 


@ 全 称 为 Enthought Tool Suite， 是 Enthought 公司 开发 的 开源 科学 计算 应 用 程序 开发 包 。 
@ 为 了 提高 程序 的 运行 效率 ， 有 时 需要 使 用 C 语言 编写 Python 的 扩展 模块 , 第 16 章 “ 用 C 语言 提高 计算 效率 ”中 介绍 的 内 容 
需要 读者 熟悉 C 语言 编程 。 
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软件 包 的 安装 和 介绍 


1.1 Python 简介 


Python 是 一 种 解释 型 、 面 向 对 象 , 动 态 的 高 级 程序 设计 语言 .自从 20 世纪 90 年 代 初 Python 
语言 诞生 至 今 ， 它 逐渐 被 广泛 应 用 于 处 理 系统 管理 任务 和 Web 编程 。 目 前 Python 已 经 成 为 最 
受 欢迎 的 程序 设计 语言 之 一 。2011 年 1 月 ， 它 被 TIOBE 编程 语言 排行 榜 评 为 2010 年 度 语言 。 
由 于 Python 语言 的 简洁 、 易 读 以 及 可 扩展 性 ， 在 国外 用 Python 做 科学 计算 的 研究 机 构 日 
益 增多 , 一 些 知名 大 学 已 经 采用 Python 教授 程序 设计 课程 。 例如 麻 省 理工 学 院 的 计算 机 科学 及 
编程 导论 课程 ?就 使 用 Python 语言 讲授 。 众多 开源 的 科学 计算 软件 包 都 提供 了 Python 的 调用 接 
口 ， 例 如 著名 的 计算 机 视觉 库 OpenCV、 三 维 可 视 化 库 VTK、 医 学 图 像 处 理 库 ITK。 而 Python 
专用 的 科学 计算 扩展 库 就 更 多 了 ， 例 如 如 下 3 个 十 分 经 典 的 科学 计算 扩展 库 : NumPy、SciPy 
和 matplotlib， 它 们 分 别 为 Python 提供 了 快速 数组 处 理 、 数 值 运 算 以 及 绘图 功能 。 因 此 Python 
语言 及 其 众多 的 扩展 库 所 构成 的 开发 环境 十 分 适合 工程 技术 、 科 研 人 员 处 理 实验 数据 、 制 作 图 
表 ， 甚 至 开发 科学 计算 应 用 程序 。 
说 起 科学 计算 ， 首 先 会 被 提 到 的 可 能 是 MATLAB。 然 而 除了 MATLAB 的 一 些 专业 性 很 
强 的 工具 箱 目前 还 无 法 替代 之 外 ，MATLAB 的 大 部 分 常用 功能 都 可 以 在 Python 世界 中 找到 相 
应 的 扩展 库 。 和 MATLAB 相 比 ， 用 Python 做 科学 计算 有 如 下 优点 : 
。 首先 ，MATLAB 是 一 款 商用 软件 ， 并 且 价 格 不 菲 。 而 Python 完全 免费 ， 众 多 开源 的 
科学 计算 库 都 提供 了 Python 的 调用 接口 。 用 户 可 以 在 任何 计算 机 上 免费 安装 Python 
及 其 绝 大 多 数 扩展 库 。 

。 其 次 , 与 MATLAB 相 比 ，Python 是 一 门 更 易学 、 更 严谨 的 程序 设计 语言 。 它 能 让 用 
户 编写 出 更 易 读 、 易 维护 的 代码 。 

。 最 后 ，MATLAB 主要 专注 于 工程 和 科学 计算 。 然 而 即使 在 计算 领域 ， 也 经 常会 遇 到 
文件 管理 、 界 面 设 计 、 网 络 通信 等 各 种 需求 。 而 Python 有 着 丰富 的 扩展 库 ， 可 以 轻 
易 完 成 各 种 高 级 任务 ， 开 发 者 可 以 用 Python 实现 完整 应 用 程序 所 需 的 各 种 功能 。 

例如 ， 笔 者 在 一 个 模拟 控制 系统 的 项 目 中 ， 完 全 用 Python 实现 了 系统 模拟 及 算法 优化 ， 


@ 此 课程 的 英文 全 称 为 Introduction to Computer Science and Programming, 它 是 麻 省 理工 学 院 的 开放 课程 之 一 , 读者 可 以 在 MIT 
开放 课程 网 (http://ocw-mit.edu) 上 找到 此 课程 的 全 部 视频 及 课件 。 
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并 在 此 基础 上 实现 了 应 用 程序 必需 的 文档 和 数据 库 管 理 、 用 户 界面 设计 、 与 机 器 设备 及 其 他 软 
件 进行 通信 等 功能 。 最 后 ， 整 个 应 用 程序 可 以 随意 安装 到 不 同 的 计算 机 上 ， 而 不 受 任何 商用 软 
件 的 使 用 条 款 限制 。 


1.2 ”安装 软件 包 


和 MATLAB 等 商用 软件 不 同 ，Python 的 众多 扩展 库 由 许多 社区 分 别 维护 和 发 布 ， 因 此 要 
一 一 将 它们 收集 齐全 并 安装 到 计算 机 中 是 一 件 十 分 耗费 时 间 和 精力 的 事情 。 本 书 介绍 两 个 科学 
计算 用 的 Python 集成 软件 包 。 读者 只 需要 下 载 并 执行 一 个 安装 程序 , 就 能 安装 好 本 书 涉及 的 所 
有 扩展 库 。 


1.2.1 Python(x,y) 


Python(x,y) 收 集 了 众多 的 扩展 库 、 文 档 和 教程 。 在 本 书 所 附 的 光盘 中 提供 了 Python(x,y) 
2.6.6 的 安装 程序 , 为 了 保证 能 正确 运行 本 书 的 所 有 实例 程序 , 推荐 读者 以 完全 安装 模式 进行 安 
装 。Python(x.y) 的 版 本 号 与 它 所 使 用 的 Python 版 本 号 相同 。 


© http://www.pythonxy.com 
Python(x;y) 官 方 网 址 


为 了 确保 本 书 的 所 有 实例 程序 都 能 正常 运行 ， 请 读者 参照 图 1-1 修改 安装 选项 。 将 安装 模 
式 修改 为 完全 安装 ， 并 将 Python(x.y) 的 安装 路 径 改 为 “c:pythonxy”。 否 则 Python 将 可 能 无 法 
正确 调用 MinGW 编译 扩展 模块 。 请 读者 在 安装 结束 之 后 ， 确 认 下 列 路 径 ， 在 今后 的 章节 中 会 
经 常用 到 它们 : 

ci\python26 Python 2.6 的 安装 路 径 ， 所 有 扩展 库 都 可 以 在 它 的 子 目录 “lib\site-packages” 下 找到 

cpythonxydoc 众多 扩展 库 的 说 明文 档 和 演示 程序 

cpythonxymingw MinGW C/C++ 编译 器 ， 在 介绍 用 C 语言 编写 扩展 模块 时 会 用 到 它 

cpythonxyswig 自动 生成 扩展 模块 接口 的 工具 ， 在 介绍 用 C 语言 编写 扩展 模块 时 会 用 到 它 


1-1 选择 “Full” 进 行 完全 安装 ， 并 将 python(x. y)” 的 安装 路 径 设 置 为 “C:\pythonxy” 


如 果 使 用 默认 的 安装 路 径 ， 那 么 “pythonxy” 目 录 会 被 安装 到 “c:\Program Files” 下 。 
Python(x.y) 提 供 了 如 图 1-2 所 示 的 启动 程序 ， 从 中 可 以 快速 启动 各 种 工具 ， 以 及 打开 文档 
教程 所 在 的 文件 夹 。 


图 1-2 Python(x.y) 的 启动 画面 


界面 中 的 3 个 选项 卡 如 下 : 

e@ Shortcuts: 启动 各 种 应 用 程序 ,包括 Eclipse、Mayavi、Spyder 集成 开发 环境 、IPython 
交互 式 命令 行 等 。 

e Documentation: 打开 扩展 库 的 文档 ， 这 里 列 出 的 文档 不 是 很 全 面 ， 推 荐 读者 直接 打 
开 “c:\pythonxyvdoc” 文 件 夹 查找 文档 。 

e About: 查看 所 安装 的 扩展 库 的 版 本 信息 。 


1.2.2 Enthought Python Distribution(EPD) 


EPD 是 一 个 商用 的 Python 发 行 版 本 ， 同 样 包括 了 众多 的 科学 软件 包 ， 而 且 作为 教学 使 用 
是 免费 的 ， 只 需要 提供 一 个 教育 单位 的 邮件 地 址 ， 就 可 以 收 到 EPD 的 教育 版 的 下 载 地 址 。 


» http://www.enthought.com/products/getepd.php 
EPD 的 官方 下 载 地 址 


1.3 ”方便 的 开发 工具 


本 节 介 绍 几 个 在 开发 和 调试 程序 时 经 常会 用 到 的 工具 软件 , 熟练 掌握 它们 的 用 法 能 够 起 到 
事半功倍 的 效果 。 为 了 展示 工具 软件 的 功能 ， 本 节 以 一 些 扩展 库 作 为 演示 。 读 者 可 以 暂时 忽略 
这 些 扩 展 库 的 用 法 ， 在 后 续 的 章节 中 会 对 它们 进行 详细 介绍 。 
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1.3.1 IPython 


IPython 是 Python 的 一 个 交互 式 命令 行 工 
具 ， 与 Python 自 带 的 命令 行 相 比 ， 它 更 容易 
使 用 ， 功 能 也 更 强大 。 它 支持 语法 高 亮 、 自 动 
补 全 、 自 动 缩 进 ， 并 且 内 置 了 许多 有 用 的 功能 
和 函数 。 
如 果 读 者 安装 了 Python(x,y), 就 可 以 从 它 
的 启动 界面 中 运行 卫 ython， 如 图 1-3 所 示 。 
从 下 拉 列 表 中 选择 想 运行 的 命令 行 配置 ， 
然后 单 击 右 侧 的 @ 或 @ 按 钮 运行 所 选 的 命令 
行 配置 。 其 中 ，“Python” 选 项 运行 Python 自 
带 的 命令 行 工 具 ， 而 “IPython(x,y)”、 一 
“Ipython(Qt) ” 、“IPython(wxPython) ”、 图 1-3 通过 Python(x.y) Home 启动 IPython 的 各 种 选项 
“ITPython(mlab)” 和 “IPython(sh)” 等 几 个 选项 ， 分 别 使 用 表 1-1 所 示 的 参数 来 运行 Python 。 


表 1-1_ 运行 IPython 的 其 他 选项 及 对 应 参数 


选 项 参数 
IPython(x.y) -pylab pxy 
IPython(Sh) -q4thread -p sh 
IPython(Qb -qthread 
IPython(wxPython) -wthread 
IPython(mlab) -wthread -p mlab 
IPython(sh) -q4thread -p sh 


单 击 @ 按 钮 将 用 一 个 名 为 Console 的 软件 启动 命令 行 , 此 软件 使 用 Windows 的 窗口 界面 封 
装 命令 行 界面 ， 并 且 具 有 标签 页 功能 。 单 击 @ 按 钮 将 用 Windows 自 带 的 命令 行 界面 进行 启动 。 

如 果 运 行 “IPython(x,y)”， 在 启动 Python 之 后 将 自动 运行 一 个 名 为 “defaultpy” 脚 本 文 
件 。 此 脚本 默认 执行 以 下 函数 库 的 导入 操作 : 


import numpy 
import scipy 
from numpy import * 


为 了 与 NumPy、SciPy 社区 的 推荐 导入 方式 一 致 ， 请 单 击 按钮 @， 在 打开 的 文件 夹 中 添加 
一 个 名 为 “myimportspy” 的 文件 ， 并 在 其 中 添加 如 下 几 行 程序 代码 : 


import numpy as np 
import scipy as sp 
import pylab as pl 


此 后 运行 “IPython(x;y)” 的 时 候 请 选择 “myimports.jpy” 作 为 启动 脚本 。 

如 果 要 在 命令 行 中 和 matplotib、TraitsUI、Mayavi 等 图 形 界面 程序 进行 交互 ， 就 需要 给 
IPython 传递 “-wthread”、“-q4thread” 或 “-pylab” 参 数 。 当 使 用 “-pylab” 参 数 时 ， 在 调用 
matplotlib 库 的 绘图 函数 进行 绘图 时 ， 将 立即 显示 图 表 。 

下 面 我 们 以 matplotlib 绘图 为 例 ， 实 际 操作 一 下 。 请 读者 选择 “myimportspy” 作 为 启动 肢 
本 ,并 运行 IPython(x.y) 命 令 行 。 然 后 在 命令 行 中 输入 下 面 的 语句 ， 如 果 一 切 顺 利 ， 将 会 立即 显 
示 出 如 图 1-4 所 示 的 正弦 波形 。 


>>> x = np.Llinspace(86，4*#+np.pi，166) 
>>> pl.plot(x, np.sin(x)) 
这 里 的 np 和 pl 是 运行 “myimports.py” 之 后 的 结果 ,它们 分 别 表示 NumPy 和 pylab 模块 。 
由 于 IPython(x.y) 的 命令 行 参数 中 有 “-pylab”，pylab 模块 中 的 所 有 符号 也 会 被 载 入 到 当前 的 名 
称 空间 中 ， 因 此 也 可 以 用 下 面 的 程序 绘制 正弦 波形 : 


>>> x = linspace(86，4*pi，166) 
>>> plot(x, sin(x)) 


图 1-4 使 用 IPython 交互 式 地 绘制 正弦 波 


本 书 中 所 有 在 IPython 下 输入 的 代码 都 用 “>>>” 作 为 提示 符 ， 而 不 使 用 IPython 命令 
筷 行 的 默认 提示 符 “I[.] 。 


在 Python 中 ， 可 以 很 方便 地 使 用 如 下 功能 : 

e 自动 补 全 : 输入 一 部 分 文字 之 后 按 Tab 键 ，IPython 将 列 出 所 有 补 全 信息 。 用 此 功能 
可 以 快速 输入 对 象 的 属性 名 或 者 进行 文件 名 补 全 。 

e 查看 文档 : 输入 需要 查看 文档 的 函数 名 ， 然 后 在 后 面 添加 一 个 或 两 个 问号 。“?” 表 
示 查 看 函数 的 文档 ，“??” 表 示 查 看 其 Python 源 代 码 。 如 果 函 数 不 是 用 Python 编写 
的 ， 就 看 不 到 其 源 代 码 。 
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e 执行 Python 程序 : 用 mm 命令 运行 指定 的 Python 程序 文件 。 默 认 是 在 一 个 新 的 环境 
中 运行 程序 ， 当 程序 退出 时 将 程序 运行 环境 中 的 对 象 复制 到 IPython 环境 中 。 如 果 运 
行 run 命令 时 添加 “-i” 参 数 ， 在 IPython 的 当前 环境 中 执行 程序 ， 程 序 即 可 直接 访 
问 IPython 环境 中 的 对 象 。 

e 执行 剪 切 板 中 的 程序 : 运行 paste 命令 将 在 IPython 环境 中 运行 前 贴 板 中 的 程序 代码 ， 
它 会 自动 删除 代码 中 的 提示 符 “>>>”。 运 行 “paste foo” 将 把 剪 切 板 中 的 内 容 复制 
到 变量 foo 中 。 变量 foo 是 Python 提供 的 SList 列表 类 型 , 它 提供 了 很 多 对 其 内 容 进 
行 操作 的 方法 。 

e 执行 系统 命令 :在 要 执行 的 系统 命令 之 前 添加 一 个 “!” 符 号 .例如 , 如果 执 行 “ttestpy”， 
那么 操作 系统 会 运行 “testpy” 文 件 。 和 run 命令 不 同 , “testpy” 将 在 另外 的 进程 中 
运行 。 

在 IPython 中 使 用 run 命令 运行 Python 程序 能 够 提高 调试 程序 的 速度 。 因 为 每 次 运行 用 户 

程序 时 ，IPython 环境 没有 初始 化 ， 已 经 载 入 的 模块 不 需要 重新 载 入 ， 对 于 NumPy、SciPy 和 
matplotlib 这 样 比较 庞大 的 库 ， 能 节省 不 少 载 入 时 间 。 下 面 是 一 个 例子 : 


是 # speedup testpy 
六 下 载 和 人 NumPy、SciPpy 和 pylab 库 并 绘制 一 个 简单 的 频率 扫描 波 


import numpy as np 

from scipy import signal 

import pylab as pl 

t = np.linspace(89，16，1666) 

x = signal.chirp(t，5，16，36) 

pl.plot(t, x) 

pl.show() 

此 程序 计算 频率 扫描 波 并 使 用 图 表 来 显示 , 如 果 通 过 双击 或 者 在 命令 行 中 输入 文件 名 来 直 
接 运 行 此 程序 ， 需 要 等 几 秒 钟 才能 看 到 结果 。 如 果 先 在 “speedup_testpy” 所 在 的 文件 夹 启动 
IPython， 然 后 运行 : 


>>> run speedup_test.py 


第 一 次 运行 时 由 于 同样 需要 载 入 所 需 的 模块 ， 因 此 所 需 的 时 间 和 直接 运行 没有 差别 ， 但 是 
再 次 运行 时 由 于 不 需要 载 入 模块 ， 因 此 结果 可 以 立即 显示 出 来 。 此 后 还 可 以 在 Python 中 输入 
程序 ， 查 看 变量 的 值 或 者 修改 界面 的 各 种 属性 ， 例 如 : 


>>> x[:5] # 查 看 扫描 波 的 前 5 个 值 

array([ 1. ， 8.95676436， 6.86716368， 8.58242516， 8.29822684] ) 
>>> pl.gca().1ines[6] .set_color("r") # 设 置 曲线 颜色 为 红色 

>>> pl.draw( ) # 刷 新 界面 


Python 的 模块 缓存 功能 虽然 可 以 加 速 程序 运行 ， 但 是 也 会 带 来 一 些 问题 。 例 如 ， 如 果 有 一 
个 名 为 “mymodelpy” 的 模块 ， 在 “usemodelpy” 中 导入 mymodel 模块 ， 那 么 只 有 在 第 一 次 
运行 “mn usemodelpy” 时 会 载 入 mymodel 模块 , 以 后 即使 “mymodelpy” 文 件 发 生 改 变 , Python 
也 不 会 重新 载 入 最 新 的 模块 。 如 果 要 修改 调试 “mymodelpy” 中 的 程序 , 就 需要 在 “usemodelpy” 
中 添加 如 下 两 行 代码 : 

import mymodel 

reload(mymodel) 


这 样 一 来 ， 每 次 运行 “usemodel.py” 时 都 会 强制 重新 载 入 mymodel 模块 。 


g mymodel.py, usemodel.py 
六 于 使 用 reload 函数 重新 载 入 模块 


IPython 还 有 很 强大 的 调试 功能 ， 例 如 下 面 的 程序 使 用 sin(x cosfw/ 计 算 一 个 长 度 为 10000 
的 数组 ， 并 且 调用 imshow0 将 此 数组 显示 成 一 个 二 维 图 像 。 


# ipython debugpy 
总 也 ”用 IPython 调试 程序 中 的 错误 


import pylab as pl 

import numpy as np 

def test debug(): 
x = np.linspace(1，56，16666) 
img = np.sin(x*np.cos(x)) 
pl.imshow(img) 
pl.show() 


test_debug() 


但 是 由 于 程序 中 有 错误 ， 在 IPython 中 运行 它 时 ， 会 出 现 很 长 一 串 错误 信息 。 下 面 给 出 的 
是 错误 信息 的 最 后 一 部 分 ， 我 们 看 到 抛 出 异常 的 是 “imagepyc” 中 的 set_data0 函 数 ， 它 是 扩展 
模块 中 的 一 个 函数 ， 错 误 信息 的 意思 是 一 作为 图 像 数 据 的 数组 的 维 数 不 正确 。 


>>> run ipython_debug.py 


[[ 省 略 ]] 
C:\Python26\lib\site-packages\matplotlib\image.pyc in set data(self, A) 
298 if (self. A.ndim not in (2, 3) or 
299 (self. A.ndim == 3 and self. A.shape[-1] not in (3, 4))): 
-->366 raise TypeError("Invalid dimensions for image data") 
381 
362 self._imcache =None 


TypeError: Invalid dimensions for image data 
WARNING: Failure executing file: <ipython_debug.py> 
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为 了 找到 程序 中 出 错 的 位 置 ， 在 IPython 中 输入 debug 命令 ， 进 入 调试 状态 ， 并 显示 出 调 
用 堆栈 的 当前 位 置 : 


>>> debug 
> c:\python26\1ib\site-packages\matplotlib\image.py(388)set data() 
299 (self. A.ndim == 3 and self. A.shape[-1] not in (3, 4))): 
-->366 raise TypeError("Invalid dimensions for image data") 
381 
ipdb> 


调试 状态 的 提示 符 为 “ipdb”， 输 入 “h” 命 令 可 以 查看 调试 状态 下 能 用 的 所 有 命令 ， 输 
入 “h 命令 名 ”可 以 查看 命令 的 详细 说 明 。 连 续 执行 多 次 “u” 命 令 ， 沿 着 调用 堆栈 往 上 济源 ， 
直到 找到 “ipython_debug.py” 中 出 错 的 那 一 行 : 
ipdb> u 
> c:\zhang\pydoc\source\examples\81-intro\ipython_debug.py(7)test_debug() 
6 img = np.sin(x*np.cos(x)) 
---->7 pl.imshow(img) 
8 pl1.show() 


由 错误 信息 可 知 数组 img 的 维 数 不 对 。 查 看 表示 数组 维 数 的 ndim 属性 ， 发 现 img 是 一 维 
数组 ， 而 imshow0 的 参数 应 该 是 二 维 数组 : 


ipdb> img.ndim 
上 


输入 “q” 命 令 结束 调试 ， 并 编辑 “ipython debugpy”， 在 调用 imshow0 之 前 添加 下 面 一 
行 代码 : 

img.shape = 160, -1 

然后 再 重新 执行 程序 ， 这 次 就 可 以 看 到 表示 二 维 数组 的 图 像 了 。 


>>> run ipython_debug.py 


1.3.2 Spyder 


Spyder 是 Python(x,y) 的 作者 为 它 开发 的 一 个 简单 的 集成 开发 环境 。 和 其 他 的 Python 开发 
环境 相 比 ， 它 最 大 的 优点 就 是 模仿 MATLAB 的 “工作 空间 ”的 功能 ， 可 以 很 方便 地 观察 和 修 
改 数 组 的 值 。 图 1-5 是 Spyder 的 界面 截图 。 


» http://code.google.com/p/spyderlib 
Spyder 项 目的 地 址 


图 1-5 在 Spyder 中 执行 图 像 处 理 的 程序 


Spyder 的 界面 由 许多 窗 格 构成 , 用户 可 以 根据 自己 的 喜好 调整 它们 的 位 置 和 大 小 。 当 多 个 
窗 格 出 现在 一 个 区 域 时 ,将 使 用 标签 页 的 形式 显示 。 例 如 在 图 1-5 中 ,可 以 看 到 “Editor”、“Object 
inspector”、“Variable explorer”、“File explorer”、“Console”、“History log” 以 及 两 个 
显示 图 像 的 窗 格 。 在 View 菜单 中 可 以 设置 是 否 显示 这 些 窗 格 。 表 1-2 中 列 出 了 Spyder 的 主要 


窗 格 及 其 作用 : 
表 1-2_Spyder 的 主要 窗 格 及 其 作用 
窗 格 名 称 作 用 
Editor 编辑 程序 ， 可 用 标签 页 的 形式 编辑 多 个 程序 文件 
Console 在 别 的 进程 中 运行 的 Python 控制 台 
Variable explorer 显示 Python 控制 台中 的 变量 列表 
Object inspector 查看 对 象 的 说 明文 档 和 源 程序 
File explorer 文件 浏览 器 ， 用 于 打开 程序 文件 或 者 切换 当前 路 径 


按 F5 键 将 运行 当前 编辑 器 中 的 程序 。 第 一 次 运行 程序 时 ， 将 弹出 一 个 如 图 1-6 所 示 的 运 
行 配置 对 话 框 。 在 此 对 话 框 中 可 以 对 程序 的 运行 进行 如 下 配置 : 


Command line options: 输入 程序 的 运行 参数 。 

Working directory: 输入 程序 的 运行 路 径 。 

Execute in current Python or IPython interpreter: 在 当前 的 Python 控制 台中 运行 程序 。 
程序 可 以 访问 此 控制 台中 的 所 有 全 局 对 象 ， 控 制 台中 已 经 载 入 的 模块 不 需要 重新 载 
入 ， 因 此 程序 的 启动 速度 较 快 。 

Execute in a new dedicated Python interpreter: 新 开 一 个 Python 控制 台 并 在 其 中 运行 程 
序 ， 程 序 的 启动 速度 较 慢 ， 但 是 由 于 新 控制 台中 没有 多 余 的 全 局 对 象 ， 因 此 更 接近 
实际 的 运行 情况 。 当 选择 此 项 时 ， 还 可 以 选中 “Interact with the Python interpreter after 
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execution” 复 选 框 ， 这 样 当 程序 结束 运行 时 ， 控 制 台 进程 将 继续 运行 ， 因 此 可 以 通过 
它 查 看 程序 运行 之 后 的 所 有 全 局 对 象 。 此 外 ， 还 可 以 在 “Command line options” 中 
输入 新 控制 台 的 启动 参数 。 
运行 配置 对 话 框 只 会 在 第 一 次 运行 程序 时 出 现 ， 如 果 想 修改 程序 的 运行 配置 ， 可 以 按 F6 
键 打 开 运行 配置 对 话 框 。 


1-6 ”运行 配置 对 话 框 


控制 台中 的 全 局 对 象 可 以 在 “Variable explorer” 窗 格 中 找到 。 此 窗 格 支持 数值 、 字 符 串 、 
元 组 、 列 表 、 字 和 典 以 及 NumPy 数组 等 对 象 的 显示 和 编辑 。 图 1-7( 左 ) 是 “Variable explorer” 窗 
格 的 截图 ， 其 中 列 出 了 当前 控制 台中 的 变量 名 、 类 型 、 大 小 以 及 内 容 。 右 击 变量 名 ， 弹 出 对 此 
变量 进行 操作 的 菜单 。 在 菜单 中 选择 Edit 选项 ， 弹 出 图 1-7( 右 ) 所 示 的 数组 编辑 窗口 。 此 编辑 
窗口 中 ， 单 元 格 的 背景 颜色 直观 地 显示 了 数值 的 大 小 。 


(oo 当 有 多 个 控制 台 运 行 时 ，“Variable explorer” 窗 格 显 示 当前 控制 台中 的 全 局 对 象 


1-7 使 用 “Variable explorer” 窗 格 查看 和 编辑 数组 的 内 容 


选择 菜单 中 的 Plot 选项 ,将 弹出 如 图 1-8 所 示 的 绘图 窗口 。 在 绘图 窗口 的 右键 菜单 中 选择 
“Parameters”， 将 弹出 一 个 编辑 绘图 对 象 的 对 话 框 。 图 1-8 中 使 用 此 对 话 框 修改 了 曲线 的 颜色 


和 线 宽 。 


Humeabid 人 ss 


图 1-8 在 “Variable explorer” 窗 格 中 将 数组 绘制 成 曲线 


Spyder 的 功能 比较 多 ， 这 里 仅 介绍 一 些 常用 的 功能 和 技巧 : 


默认 配置 下 ,“Variable explorer” 窗 格 中 不 显示 以 大 写字 母 开 头 的 变量 ， 可 以 单 击 工 
具 栏 中 的 配置 按钮 (最 后 一 个 按钮 )， 在 菜单 中 取消 “Exclude capitalized references” 的 
选中 状态 。 

在 控制 台中 , 可 以 按 Tab 按键 进行 自动 补 全 。 在 变量 名 之 后 输入 “?”, 可 以 在 “Object 
inspector” 窗 格 中 查看 对 象 的 说 明文 档 。 此 窗 格 的 Options 菜单 中 的 “Show source” 

选项 可 以 开启 显示 函数 的 源 程 序 。 

可 以 通过 “Working directory” 工 具 栏 修改 工作 路 径 ， 用 户 程序 运行 时 ， 将 以 此 工作 
路 径 作为 当前 路 径 。 例 如 我 们 只 需要 修改 工作 路 径 ， 就 可 以 用 同一 个 程序 处 理 不 同 
文件 夹 下 的 数据 文件 。 

在 程序 编辑 窗口 中 按 住 Ctl 键 ， 并 单 击 变量 名 、 函 数 名 、 类 名 或 模块 名 ， 可 以 快速 
跳 转 到 定义 位 置 。 如 果 是 在 别 的 程序 文件 中 定义 的 ， 将 打开 此 文件 。 在 学 习 一 个 新 
模块 的 用 法 时 ， 我 们 经 常 需要 查看 模块 中 的 某 个 函数 或 类 是 如 何 实现 的 ， 使 用 此 功 
能 可 以 帮助 我 们 快速 查看 和 分 析 各 个 模块 的 源 程序 。 例 如 下 面 的 程序 从 不 同 的 扩展 
库 载 入 了 一 些 模块 和 类 。 用 Spyder 打开 此 文件 ， 按 住 Ctrl 键 ， 并 单 击 signal、Ppl、 

HasTraits、Instance、View、Item、lfilter、plot、title 等 ， 将 打开 定义 它们 的 程序 文件 ， 
并 跳 转 到 相应 的 行 。 


# gotodefine.py 
半 一 测试 定义 跳 转 功能 
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from scipy import signal 

import pylab as pl 

from enthought.traits.api import HasTraits, Instance 
from enthought.traits.ui.api import View, Item 


signal.lfilter 
pl.plot 
pl.title 


1.3.3 Wing IDE 101 


Wing IDE 是 一 个 功能 强大 的 Python 集成 开发 环境 ， 它 的 专业 版 是 商用 软件 ， 但 是 也 提供 
了 一 个 免费 的 简装 版 本 Wing IDE 101。 


» http://www.wingware.cony/downloads/wingide-101 
Wing IDE 101 的 下 载 地 址 


和 Spyder 一 样 , 在 Wing IDE 中 只 需要 按 住 Ctrl 键 并 同时 单 击 函 数 名 或 类 名 ， 就 能 直接 跳 
转 到 定义 它 的 位 置 。 此外, Wing IDE 还 有 不 错 的 调试 功能 。 在 程序 中 设置 断 点 之 后 , 单 击 Debug 
按钮 就 可 以 进入 调试 运行 模式 。 当 运行 到 断 点 之 后 ， 程 序 将 暂停 运行 。 读 者 可 以 用 Wing IDE 
打开 下 面 的 程序 ， 并 将 光标 移 到 “selfcount += 1” 一 行 ， 按 F9 键 添加 断 点， 然后 按 FS 键 开 始 
调试 程序 。 


吉 wingide debugpy 
全 一 测试 WingIDE 的 断 点 调试 功能 


图 1-9 是 调试 程序 时 的 界面 截图 。 程 序 执行 之 后 会 显示 出 一 个 小 窗口 ， 其 中 有 一 个 名 为 
“Click Me” 的 按钮 ， 单 击 它 将 调用 程序 中 的 _button_fired0， 遇 到 断 点 从 而 暂停 程序 运行 。 此 
时 可 以 观察 程序 的 调用 堆栈 (Call stack) 和 堆栈 数据 (Stack Data) 。 

在 主 窗口 左 侧 的 “Stack Data” 窗 格 中 ， 显 示 了 locals 和 globals 两 个 字典 ， 它 们 分 别 是 当 
前 执行 环境 下 的 全 局 变量 和 当前 堆栈 位 置 中 的 局 部 变量 。 下 半 部 分 显示 了 被 选中 的 名 为 self 的 
局 部 变量 的 内 容 。 在 主 窗口 下 方 的 “Call Stack” 窗 格 中 显示 了 执行 到 断 点 处 的 调用 堆栈 ， 其 中 
堆栈 的 顶部 ， 即 最 下 面 一 行 被 选中 。 可 以 用 鼠标 选中 堆栈 中 的 其 他 调用 点 ， 程 序 编辑 窗 格 和 
“Stack Data” 窗 格 中 的 内 容 也 随 之 发 生变 化 。 通 过 这 种 方法 可 以 观察 堆栈 中 的 所 有 局 部 变量 ， 
了 解 运行 到 断 点 处 的 整个 调用 过 程 ， 并 查看 与 其 相关 的 源 程序 。 


图 1-9 用 Wing IDE 101 调试 程序 


1.4 函数 库 介 绍 


Python 的 科学 计算 功能 由 众多 的 扩展 库 协作 完成 。 在 本 书 的 后 续 章节 中 , 将 对 下 列 扩展 库 
进行 详细 介绍 。 
1.4.1 数值 计算 库 


NumPy 为 Python 带 来 了 真正 的 多 维 数组 功能 ， 并 且 提供 了 十 分 丰富 的 对 数组 进行 处 理 和 
运算 的 函数 集 。 它 对 常用 的 数学 函数 进行 数组 化 ， 使 这 些 数 学 函数 能 直接 对 数组 进行 运算 ， 将 
本 来 需要 在 Python 中 进行 的 循环 运算 , 转移 到 高 效率 的 库 函数 中 , 充分 利用 这 些 函数 能 明显 地 
提高 程序 的 运算 速度 。 

SciPy 则 在 NumpPy 的 基础 之 上 添加 了 许多 科学 计算 的 函数 库 , 其 中 一 些 函 数 是 通过 对 久 经 
考验 的 Fortran 数值 计算 库 进行 封装 实现 的 ， 例 如 : 

e 线性 代数 使 用 LAPACK 库 

。 快速 傅立叶 变换 使 用 FFTPACK 库 

。 常 微分 方程 求解 使 用 ODEPACK 库 

。 非 线性 方程 组 求解 以 及 最 小 值 求解 等 使 用 MINPACK 库 


http://www.scipy.org 
Scipy 官方 网 址 
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有 了 这 两 个 库 ，Python 就 有 几乎 和 MATLAB 一 样 的 数据 处 理 能 力 了 。 此 外 ，SciPy 中 的 
Weave 模块 能 在 Python 程序 中 直接 嵌入 C++ 程序 ， 进 一 步 提高 程序 的 运算 速度 。 


1.4.2 符号 计算 库 


SympPy 是 一 套数 学 符号 运算 的 扩展 库 ， 虽然 它 目前 还 没有 到 达 1.0 版 本 ,但 是 已 经 足够 好 
用 ， 可 以 帮助 我 们 进行 公式 推导 ， 做 一 些 简单 的 符号 运算 工作 。 


2 http:/code.google.comy/p/sympy 
Sympy 官方 网 址 


1.4.3 ”界面 设计 


Python 可 以 使 用 多 种 界面 库 编写 GUI 程序 ， 例 如 以 TK 为 基础 的 Tkinter、 以 wxWidgets 
为 基础 的 wxPython、 以 QT 为 基础 的 pyQt4 等 界面 库 。 但 是 使 用 这 些 界面 库 编写 GUI 程序 仍 
然 是 一 件 十 分 繁杂 的 工作 。 为 了 让 读者 不 在 界面 设计 上 耗费 大 量 精力 ， 从 而 能 把 注意 力 集中 到 
数据 处 理 上 ， 本 书 详细 介绍 了 如 何 使 用 Traits 库 设计 图 形 界面 程序 。 


» http://code.enthought.com/projects/traits 
Traits 官方 网 址 


Traits 库 分 为 Traits 和 TraitsUI 两 大 部 分 ， 使 用 Traits 能 对 Python 对 象 的 属性 进行 类 型 定 
义 ， 并 为 其 添加 初始 化 、 校 验 、 代 理 、 事 件 处 理 等 诸多 功能 。 

TraitsUI 库 基于 Traits 库 ， 使 用 MVC( 模 型 一 视图 一 控制 器 ) 模 式 快速 地 定义 用 户 界面 ， 在 
最 简单 的 情况 下 ， 甚 至 不 需要 写 一 句 界面 相关 的 代码 ， 就 可 以 通过 Traits 的 属性 定义 获得 一 个 
可 用 的 图 形 界面 。 使 用 TraitsUI 库 编写 的 程序 自动 支持 wxPython 和 pyQt 界面 库 。 


1.4.4 ”绘图 与 可 视 化 


matplotlib 和 Chaco 是 两 个 很 优秀 的 二 维 绘图 库 。matplotlib 库 能 够 快速 地 绘制 精美 的 图 表 、 
以 多 种 格式 输出 ， 并 且 带 有 简单 的 三 维 绘图 功能 。 而 Chaco 则 以 Traits 为 基础 ， 能 够 很 方便 地 
编写 出 交互 式 图 表 控件 ， 并 嵌入 到 用 TraitsUI 编写 的 界面 程序 中 。 


» http://code.enthought.com/projects/chaco 
Chaco 官方 网 址 


© http://matplotlib.sourceforge.net 
matplotlib 官方 网 址 


TVTK 库 对 标准 的 VTK 库 用 Traits 进行 了 封装 ， 如 果 要 在 Python 中 使 用 VTK, 用 TVTK 
是 最 方便 的 选择 。Mayavi 则 在 TVTK 的 基础 上 添加 了 一 套 面 向 应 用 的 方便 工具 ， 它 既 可 以 单 
独 作 为 三 维 可 视 化 程序 使 用 ， 也 可 以 很 方便 地 嵌入 到 用 TraitsUI 编写 的 界面 程序 中 。 


http://code.enthought.com/projects/mayavi 
Mayavi 官方 网 址 


雹 


VTK(Visualization Toolkit) 

视觉 化 工具 库 (Visualization Toolkit, VTK) 是 一 个 开放 源码 、 跨 平台 、 支援 平行 处 理 (VTK 
曾 用 于 处 理 大 小 近乎 1 个 PB 的 资料 ， 其 平台 为 美国 Los Alamos 国家 实验 室 的 具 1024 个 处 
理 器 的 大 型 系统 ) 的 图 形 应 用 函数 库 。2005 年 曾 被 美国 陆军 研究 实验 室 用 于 即时 模拟 俄罗斯 
制 反 导弹 战 车 ZSU23-4 受到 平面 波 攻击 的 情形 ， 其 计算 节点 高 达 25 万 个 之 多 。 


此 外 ， 使 用 VPython 库 能 够 快速 、 方 便 地 制作 三 维 动画 演示 ， 使 数据 更 有 说 服 力 。 


2 http://vpython.org 
VPython 官方 网 址 


1.4.5 ”图 像 处 理 和 计算 机 视觉 


OpenCV 最 初 是 由 英特尔 公司 开发 的 一 套 开源 的 跨 平台 计算 机 视觉 库 ， 可 用 于 开发 实时 的 
图 像 处 理 、 计 算 机 视觉 以 及 模式 识别 程序 。 它 有 多 套 Python 的 调用 接口 ， 本 书 将 以 其 中 的 
pyOpenCV 为 例 介绍 OpenCV 的 一 些 基 础 知识 。pyOpenCV 库 不 但 很 全 面 地 对 OpenCV 的 各 种 
函数 和 类 进行 了 封装 ， 而 且 能 在 OpenCV 的 图 像 对 象 和 NumPy 数组 之 间 进 行 互 换 。 这 样 便 同 
时 扩展 了 NumPy 的 图 像 处 理 能 力 以 及 OpenCV 的 数组 处 理 能 力 。 


© http://code.google.com/p/pyopenev/ 
pyopencv 项 目的 地 址 
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标准 的 Python 中 用 列表 (lisb 保 存 一 组 值 ,可 以 当 作 数 组 使 用 。 但 由 于 列表 的 元 素 可 以 是 任 
何 对 象 ， 因 此 列表 中 保存 的 是 对 象 的 指针 。 这 样 一 来 ， 为 了 保存 一 个 简单 的 列表 [1,2,3]， 就 需 
要 有 三 个 指针 和 三 个 整数 对 象 。 对 于 数值 运算 来 说 ， 这 种 结构 显然 比较 浪费 内 存 和 CPU 计算 
时 间 。 

此 外 Python 还 提供 了 array 模块 ， 它 所 提供 的 array 对 象 和 列表 不 同 ， 能 直接 保存 数值 ， 
和 C 语言 的 一 维 数组 类 似 。 但 是 由 于 它 不 支持 多 维 数组 ， 也 没有 各 种 运算 函数 ， 因 此 也 不 适合 
做 数值 运算 。 

Numpy 的 诞生 弥补 了 这 些 不 足 ，NumPy 提供 了 两 种 基本 的 对 象 : ndarray” 和 ufunc”。 
ndarray( 下 文 统一 称 之 为 数组 ) 是 存储 单一 数据 类 型 的 多 维 数组 ， 而 ufunc 则 是 能 够 对 数组 进行 
处 理 的 函数 。 


2.1 ndarray 对 象 


函数 库 的 导入 
本 书 的 示例 程序 假设 用 以 下 推荐 的 方式 导入 Numpy 函数 库 : 
import numpy as np 


2.1.1 创建 数组 


Numpy 的 函数 和 方法 都 有 详细 的 说 明文 档 和 用 法 示例 。 在 Python 中 输入 函数 名 并 添 
加 一 个 “2?” 符 号 ,就 可 以 显示 文档 内 容 。 例 如 ， 输 入 “np.aray?” 可 以 查看 array0 
的 说 明 。 


首先 需要 创建 数组 才能 对 其 进行 运算 和 操作 。 可 以 通过 给 array0 函 数 传 递 Python 的 序列 
对 象 来 创建 数组 。 如 果 传 递 的 是 多 层 嵌 套 的 序列 ， 将 创建 多 维 数组 (下 例 中 的 变量 0): 


A numpy_intropy 
全 < Numpy 的 基本 使 用 方法 


@ 英文 全 称 为 n-dimensional array object。 
回 英文 全 称 为 universal fnction object。 


>>> a = np.array([1, 2, 3, 4]) 
>>> b = np.array((5, 6, 7, 8)) 
9 pTray(lli 2 3 [25655275 [7 85 9, 20]]y 
>>> b 
array([5，6，7，8]) 
>>> C 
array([[1，2，3，4]， 
[4，5，6，7]， 
[7，8，9，16]]) 


数组 的 形状 可 以 通过 其 shape 属性 获得 ， 它 是 一 个 描述 数组 各 个 轴 长 度 的 元 组 (tuple): 


>>> a.shape 
(4,) 

>>> c.shape 
G3, 4) 


数组 a 的 shape 属性 只 有 一 个 元 素 ， 因 此 它 是 一 维 数组 。 而 数组 的 shape 属性 有 两 个 元 
素 ， 因 此 它 是 二 维 数组 ， 其 中 第 0 轴 的 长 度 为 3， 第 1 轴 的 长 度 为 4。 还 可 以 通过 修改 数组 的 
shape 属性 ， 在 保持 数组 元 素 个 数 不 变 的 情况 下 ， 改 变数 组 每 个 轴 的 长 度 。 下 面 的 例子 将 数组 c 
的 shape 属性 改 为 (4,3)， 注 意 ， 从 (3,4) 改 为 (4.3) 并 不 是 对 数组 进行 转 置 ， 而 只 是 改变 每 个 轴 的 
大 小 ， 数 组 元 素 在 内 存 中 的 位 置 并 没有 改变 。 


>>> c.shape = 4,3 


>>> C 

array([[ 1, 2, :3]， 
Ln 4 Sl 
[6, 7, 7], 
[ 8, 9, 10]]) 


当 设 置 某 个 轴 的 元 素 个 数 为 -1 时 ， 将 自动 计算 此 轴 的 长 度 。 由 于 数组 c 中 有 12 个 元 素 ， 
因此 下 面 的 程序 将 数组 c 的 shape 属性 改 为 了 (2.6): 


>>> c.shape = 2,-1 

>>>C 

array([[ 3，2 3, 4，4，5]， 
Lo a Bs 9 0 


使 用 数组 的 reshape0 方 法 ， 可 以 创建 指定 形状 的 新 数组 ， 而 原 数 组 的 形状 保持 不 变 : 


>>> d = a.reshape((2,2)) # 也 可 以 用 a.reshape(2,2) 
>>> d 
array([[1，2]， 


广内 肖 序 族 过 一 人 dunN 


并 风尘 序 族 潮 一 人 dunN 
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[3，4]]) 
>>> 
array([1，2，3，4]) 


数组 a 和 d 其 实 共享 数据 存储 空间 , 因此 修改 其 中 任意 一 个 数组 的 元 素 都 会 同时 修改 另外 
一 个 数组 的 内 容 : 


>>> a[1] = 166 # 将 数组 a 的 第 一 个 元 素 改 为 198 
>>> d # 注意 数组 d 中 的 2 也 被 改 为 了 168 
array([[ 1，166]， 

[3 4]]) 


数组 的 元 素 类 型 可 以 通过 dtype 属性 获得 。 前 面 例子 中 ， 创 建 数组 所 用 序列 的 元 素 都 是 整 
数 ， 因 此 所 创建 的 数组 的 元 素 类 型 是 整 型 ， 并 且 是 32 bit 的 长 整 型 : 


>>> c.dtype 
dtype('int32') 


可 以 通过 dtype 参数 在 创建 数组 时 指定 元 素 类 型 ， 注 意 float 是 64 bit 的 双 精 度 浮 点 类 型 ， 
而 complex 是 128 bit 的 双 精 度 复 数 类 型 : 


>>> np.array([1, 2, 3, 4], dtype=np.float) 
ra a 2 4 

>>> np.array([1, 2, 3, 4], dtype=np.complex) 
array([ 1.+6.j， 2.+6.j， 3.+10.j, 4.+6.j]) 


Numpy 中 的 数据 类 型 都 有 几 种 字符 串 表 示 方 式 ， 字 符 串 和 类 型 之 间 的 对 应 关系 都 存储 在 
typeDict 字典 中 ， 例 如 'd'、'double'"、'float64' 都 表示 双 精 度 浮 点 类 型 : 


>>> np.typeDict["d"] 
<type “numpy.float64 "> 
>>> np.typeDict["double"] 
<type “numpy.float64 "> 
>>> np.typeDict["float64"] 
<type “numpy.float64 "> 


完整 的 类 型 列表 可 以 通过 下 面 的 语句 得 到 , 它 将 typeDict 字 典 中 所 有 的 值 转换 为 一 个 集合 ， 
从 而 去 除 其 中 的 重复 项 : 


>>> set(np.typeDict.values()) 

set([<type ‘numpy.bool_'> ,<type “numpy.int8 "> 5<type ‘numpy.int16'> 
<type “numpy.float32"> ,<type “numpy.uint8'> 5<type ‘numpy.complex128'> 
<type “numpy.unicode “> ,<type ‘numpy.uint64'> ,<type ‘numpy.int64'> 
<type ‘numpy.complex64'> ,<type ‘numpy.string “> ,<type ‘numpy.uint32'> 


<type “numpy.void '> 5<type ‘numpy.int32'> »<type “numpy.float96 "> 
<type “numpy.object “> ,<type “numpy.uint32 > »<type “numpy.int32 "> 
<type “numpy.float64'> ,<type ‘numpy.complex192'>,<type ‘numpy.uint16'> ]) 


前 面 的 例子 都 是 先 创建 一 个 Python 的 序列 对 象 ， 然 后 通过 array0 将 其 转换 为 数组 ， 这 样 
做 显然 效率 不 高 。 因 此 NumPy 提供 了 很 多 专门 用 于 创建 数组 的 函数 。 下 面 的 每 个 函数 都 有 一 
些 关键 字 参 数 ， 具 体 用 法 请 查看 函数 说 明 。 

arange0 类 似 于 内 置 函数 range0， 通 过 指定 开始 值 、 终 值 和 步 长 创建 表示 等 差 数列 的 一 维 
数组 ， 注 意 得 到 的 结果 数组 不 包含 终 值 。 例 如 下 面 的 程序 创建 开始 值 为 0、 终 值 为 1、 步 长 为 
0.1 的 等 差 数组 ， 注 意 终 值 1 不 在 数组 中 : 


>>> np.arange(9,1,6.1) 
array([ 8. ， 6.1，6.2，8.3，8.4，6.5，8.6，68.7，8.8，8.9]) 


linspace0 通 过 指定 开始 值 、 终 值 和 元 素 个 数 创建 表示 等 差 数 列 的 一 维 数组 ， 可 以 通过 
endpoint 参 数 指定 是 否 包含 终 值 ,默认 值 为 True, 即 包含 终 值 。 下 面 两 个 例子 分 别 演示 了 endpoint 
为 Tme 和 False 时 的 结果 ， 注 意 endpoint 的 值 会 改变 数组 的 等 差 步 长 : 


>>> np.linspace(8，1，18) # 步 长 为 1/9 

array([ 9. ， @.11111111, 98.22222222， 9.33333333， 8.44444444， 
8.55555556， 6.66666667， 8.77777778， 8.88888889， 1. ]) 

>>> np.1linspace(6，1，16，endpoint=False) # 步 长 为 1/16 

array([ 6. ,0.1, 0.2, 0.3, 8.4, 98.5, 08.6, 8.7,，08.8，9.9]) 


logspace0 和 linspace0 类 似 ， 不 过 它 所 创建 的 数组 是 等 比 数列 。 下 面 的 例子 产生 从 10? 到 
10*、 有 5 个 元 素 的 等 比 数列 ， 注 意 起 始 值 0 表示 10"， 而 终 值 2 表示 10?: 


>>> np.logspace(9, 2, 5) 
array([ 1. ， 3.16227766, 16. ， 31.6227766 ， 166. ]) 


基数 可 以 通过 base 参数 指定 ,默认 值 为 10。 下 面 通过 将 base 参数 设置 为 2, 并 设置 endpoint 
参数 为 False， 创 建 一 个 比例 为 2 等 比 数组 s: 


>>> np.1ogspace(86，1，12，base=2，endpoint=False) 

array([ 1. ， 1.65946369， 1.12246265， 1.18929712， 1.25992165， 
1.33483985, 1.41421356, 1.49836768， 1.58746165， 1.68179283， 
1.78179744, 1.88774863]) 


zeros0、ones0、empty0 可 以 创建 指定 形状 和 类 型 的 数组 。 其 中 : empty0 仅 仅 分 配 数组 所 
使 用 的 内 存 ， 不 对 数组 元 素 进行 初始 化 操作 ， 因 此 它 的 运行 速度 是 最 快 的 。 下 面 的 程序 创建 一 
个 形状 为 (2,3)、 元 素 类 型 为 整数 的 数组 : 


图 此 等 比 数组 的 比值 是 音乐 中 相差 半音 的 两 个 音阶 之 间 的 频率 比值 ， 因 此 可 以 用 它 计算 一 个 八 度 中 所 有 半音 的 频率 。 
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>>> np.empty((2,3),np.int) # 只 分 配 内存 ， 不 对 其 进行 初始 化 
array([[ 32571594, 32635312, 565219724] , 
[ 45001384, 1852386928, 665972]]) 


而 zeros0 则 将 数组 元 素 初始 化 为 0, ones0 将 数组 元 素 初始 化 为 1。 下 面 创 建 一 个 长 度 为 4、 
元 素 类 型 为 浮 点 数 的 一 维 数组 ， 并 且 元 素 全 部 初始 化 为 0: 


>>> np.zeros(4, np.float) # 元 素 类 型 默认 为 np.float， 因 此 这 里 可 以 省 略 
array([ 6.， 6.，86.，6.]) 


此 外 ，zeros_ like0、ones like0、empty_likeO) 等 函数 可 创建 与 参数 数组 的 形状 及 类 型 相同 
的 数组 。 因 此 , “zeros_like(a)” 和 “zeros(a.shape, a.dtype)” 的 效果 相同 。 

使 用 fombuffer0、fromstring0、fromtfile0 等 函数 可 以 从 字 节 序列 或 文件 创建 数组 ， 下 面 以 
ftomstring0 为 例 介绍 它们 的 用 法 。 先 创建 一 个 包含 8 个 字符 的 字符 串 s: 


>>> s = "abcdefgh" 


Python 的 字符 串 实际 上 是 一 个 字 节 序列 ， 每 个 字符 占 一 个 字 节 ， 因 此 如 果 从 字符 串 s 创建 
一 个 8 bit 的 整数 数组 ， 所 得 到 的 数组 正好 就 是 字符 串 中 每 个 字符 的 ASCII 编码 : 


>>> np.fromstring(s，dtype=np.int8) 
array([ 97, 98, 99，166，161，162，163，164] ，dtype=int8) 


如 果 从 字符 串 s 创建 16 bit 的 整数 数组 ， 那 么 两 个 相 邻 的 字 节 就 表示 一 个 整数 ， 把 字 节 98 
和 字 节 97 当 作 一 个 16 位 的 整数 ， 它 的 值 就 是 98*256+97=25185。 可 以 看 出 ，16 bit 的 整数 是 
以 低位 字 节 在 前 (little-endian) 的 方式 保存 在 内 存 中 的 。 


>>> np.fromstring(s, dtype=np.int16) 
array([25185, 25699, 26213, 26727], dtype=int16) 
>>> 98*256+97 

25185 


如 果 把 整个 字符 串 转换 为 一 个 64 bit 的 双 精度 浮 点 数 数 组 ， 那 么 它 的 值 是 : 


>>> np.fromstring(s, dtype=np.float) 
array([ 8.54688322e+194]) 


显然 这 个 结果 没有 什么 意义 ， 但 是 如 果 我 们 用 C 语言 的 二 进 制 方式 写 了 一 组 double 类 型 
的 数值 到 某 个 文件 中 ， 那么 就 可 以 从 此 文件 中 读 取 相应 的 数据 ， 并 通过 fromstring0 将 其 转换 为 
float64 类 型 的 数组 。 或 者 直接 使 用 fromfile0 从 二 进 制 文件 中 读 取 数据 。 

还 可 以 先 定义 一 个 从 下 标 计算 数值 的 函数 ， 然 后 用 fromfunction0 通 过 此 函数 创建 数组 : 


>>> def func(i): 


return iX4+1 


>>> np.fromfunction(func，(19,)) 
Na 


fromfunction0 的 第 一 个 参数 为 计算 每 个 数组 元 素 的 函数 ， 第 二 个 参数 指定 数组 的 形状 。 因 
为 它 支持 多 维 数组 ， 所 以 第 二 个 参数 必须 是 一 个 序列 。 上 例 中 第 二 个 参数 是 长 度 为 1 的 元 组 
(10,)， 因 此 创建 了 一 个 有 10 个 元 素 的 一 维 数组 。 

下 面 的 例子 创建 一 个 表示 九 九 乘法 表 的 二 维 数组 ， 输 出 的 数组 a 中 的 每 个 元 素 ali, j] 都 等 
于 fnc2(i, j): 


>>> def func2(i, j): 
return (i+1) * (j+1) 


>>> a = np.fromfunction(func2, (9,9)) 


>>> a 
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2.1.2 ” 存 取 元 素 


a numpy_accessld.py 
一 维 数组 的 元 素 存 取 


可 以 使 用 和 列表 相同 的 方式 对 数组 的 元 素 进行 存 取 : 


>>> a = np.arange(16) 

>>> a 

array([0, 1, 2, 3, 4, 5, 6, 7, 8, 9]) 

>>> a[5] ”# 用 整数 作为 下 标 可 以 获取 数组 中 的 某 个 元 素 

5 

>>> a[3:5] # 用 切片 作为 下 标 可 以 获取 数组 的 一 部 分 ， 包 括 a[3] 但 不 包括 a[5] 
array([3，4]) 

>>> a[:5]  # 切片 中 省 略 开始 下 标 ， 表 示 从 a[6] 开 始 

array([6 1, 2, 3, 4]) 
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>>> a[:-1] # 下 标 可 以 使 用 负数 ， 表 示 从 数组 最 后 往 前 数 

rray([lO> 1 2 .34 5 6 Ts BI) 

>>> a[2:4] = 166,161  ”# 下 标 还 可 以 用 来 修改 元 素 的 值 

>>> a 

apray(l 0. 1 100 101 4 5x 6 7 BI]) 

>>> a[1:-1:2]  ”# 切片 中 的 第 三 个 参数 表示 步 长 ，2 表示 隔 一 个 元 素 获取 一 个 元 素 
acray([ 1 101 5 7]) 

>>> a[::-1] # 省 略 切片 的 开始 下 标 和 结束 下 标 ， 步 长 为 -1， 表 示 整 个 数组 头 尾 颠倒 
neray(tl 9 人 7 的 5 00570023 人) 

>>> a[5:1:-2] # 步 长 为 负数 时 ， 开 始 下 标 必须 大 于 结束 下 标 

array([ 5，161]) 


和 列表 不 同 的 是 ， 通 过 切片 获取 的 新 数组 是 原始 数组 的 一 个 视图 。 它 与 原始 数组 共享 同一 
块 数据 存储 空间 : 


>>> b = a[3:7] # 通过 切片 产生 一 个 新 的 数组 bp，b 和 a 共享 同一 块 数据 存储 空间 
>>> b 

array([191， 4, 5, 6]) 

>>> b[2] = -18 # 将 b 的 第 2 个 元 素 修改 为 -19 

>>> b 

array([161， 4, -16, 6]) 

>>> a # a 的 第 5 个 元 素 也 被 修改 为 -16 

array([ 6， 1，168，161， 4, -10, 6, 7, 8, 9]) 


除了 使 用 切片 下 标 存 取 元 素 之 外 ，NumPy 还 提供 了 整数 列表 、 整 数 数组 和 布尔 数组 等 几 
种 高 级 下 标 存 取 方 法 。 

当 使 用 整数 列表 对 数组 元 素 进行 存 取 时 ， 将 使 用 列表 中 的 每 个 元 素 作为 下 标 。 使 用 列表 作 
为 下 标 得 到 的 数组 不 和 原始 数组 共享 数据 : 


>>> x = np.arange(16,1,-1) 

33> xX 

nmol 9 18 Tr 05 S53 4 3 2) 

>>> x[[3，3，1，8]] # 获取 数组 x 中 下 标 为 3、3、1、8 的 4 个 元 素 ， 组 成 一 个 新 的 数组 
array([?7, 7, 9> 2]) 

>>> b = x[[3,3,-3,8]] # 下 标 可 以 是 负数 

>>> b[2] = 166 

>>> b 

array([7，7，166，2]) 

>>> x “# 由 于 数组 b 和 x 不 共享 数据 空间 ， 因 此 数组 x 中 的 值 并 没有 改变 
array([18, 9 8, 7, 6, 5; 4, 3, 2]) 

>>> x[[3,5,1]] = -1，-2，-3 # 整数 序列 下 标 也 可 以 用 来 修改 元 素 的 值 
> 4 

array([319 =3, 8， ~1, '6, -2, 4, 3; 2]) 


当 使 用 整数 数组 作为 数组 下 标 时 ， 将 得 到 一 个 形状 和 下 标 数组 相同 的 新 数组 ， 新 数组 的 每 
个 元 素 都 是 用 下 标 数组 中 对 应 位 置 的 值 作 为 下 标 从 原 数组 获得 的 值 。 当 下 标 数组 是 一 维 时 ， 结 
果 和 用 列表 作为 下 标的 结果 相同 : 


>>> x = np.arange(16,1,-1) 
>>> x[np.array([3,3,1,8])] 
array([7，7，9，2]) 


而 当下 标 是 多 维 数组 时 ， 则 得 到 的 也 是 多 维 数组 。 我 们 可 以 将 其 理解 为 : 先 将 下 标 数组 展 
平 为 一 维 数组 ， 并 作为 下 标 获得 一 个 新 的 一 维 数组 ， 然 后 再 将 其 形状 修改 为 下 标 数 组 的 形状 : 


>>> x[np.array([[3,3,1,8],[3,3,-3,8]])] 
array([[7, 7, 9, 2], 
[7, 7, 4, 2]]) 
>>> x[[3,3,1,8,3,3,-3,8]].reshape(2,4) # 改变 数组 形状 
array([[7 7, 9; 2]; 
[7, 7, 4, 2]]) 


当 使 用 布尔 数组 b 作为 下 标 存 取 数组 x 中 的 元 素 时 , 将 收集 数组 x 中 所 有 在 数组 b 中 对 应 
下 标 为 True 的 元 素 。 使 用 布尔 数组 作为 下 标 获得 的 数组 不 和 原始 数组 共享 数据 内 存 ， 注 意 这 
种 方式 只 对 应 于 布尔 数组 ， 不 能 使 用 布尔 列表 。 


>>> x = np.arange(5,8, -1) 

>>> x 

‘aray([5s 4 3 2 41) 

>>> # 布尔 数组 中 下 标 为 @、2 的 元 素 为 True， 因 此 获取 数组 x 中 下 标 为 6、2 的 元 素 
>>> x[np.array([True, False, True, False, False])] 

array([5, 3]) 

>>> # 如 果 是 布尔 列表 ， 则 把 True 当 作 1，False 当 作 6， 按照 整数 序列 方式 获取 数组 x 中 的 元 素 
>>> x[[True, False, True, False, False]] 

array([4, 5, 4, 5, 5]) 

>>> # 布尔 数组 的 长 度 不 够 时 ， 不 够 的 部 分 都 当 作 False 

>>> x[np.array([True，False，True，True])] 

array([5, 3, 2]) 

>>> # 布尔 数组 下 标 也 可 以 用 来 修改 元 素 

>>> x[np.array([True, False, True, True])] = -1, -2, -3 

>>> x 

array([-1, 4, -2, -3, 1]) 


布尔 数组 一 般 不 是 手工 产生 ， 而 是 使 用 布尔 运算 的 ufunc 函数 产生 ， 关 于 ufme 函数 请 参 
照 2.2 节 ， 下 面 我 们 举 一 个 简单 的 例子 说 明 布尔 数组 下 标的 用 法 : 


>>> x = np.random.rand(18) # 产生 一 个 长 度 为 19、 元 素 值 为 8 到 1 的 随机 数组 


>>> Xx 
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array([ 8.72223939, 8.921226 ， 6.7776865 ， 6.2655647 ， 8.17567449， 

8.95799412， 8.12615178， 8.7627683 ， 8.43266184， 8.91379859]) 
>>> x>8.5 
>>> # 数组 x 中 的 每 个 元 素 和 8.5 进行 大 小 比较 ， 得 到 一 个 布尔 数组 ，True 表示 x 中 对 应 的 值 大 于 8.5 
array([ True，True，True，False，False，True，False，True，False，True]，dtype=bool) 
>>> # 使 用 x>8.5 得 到 的 布尔 数组 收集 x 中 的 元 素 ， 因 此 结果 就 是 包含 x 中 所 有 大 于 9.5 的 元 素 的 数组 
>>> x[x>8.5] 


array([ 8.72223939, 8@.921226 ， 6.7776865 ， 8.95799412, 8.7627883, 8.91379859]) 


2.1.3 ”多 维 数组 


多 维 数组 的 存 取 和 一 维 数组 类 似 ， 因 为 多 维 数组 有 多 个 轴 ， 因 此 它 的 下 标 需要 用 多 个 值 表 
示 。NumPy 采用 元 组 (tuple) 作 为 数组 的 下 标 ， 元 组 中 的 每 个 元 素 和 数组 的 每 个 轴 对 应 。 图 2-1 
显示 了 一 个 形状 为 (6.6) 的 数组 a， 图 中 用 不 同 颜色 和 线 型 标识 出 各 个 下 标 对 应 的 选择 区 域 。 


_ mmpy access2dpy 
a 多 维 数组 的 元 素 存 取 


a[4:,4: i 
nt 中 |29| 21 |22| 2 |24| 25 
堪 


a[l2::2,:52]】 59 5S1ls2)j 53 ,54 55 


图 2-1 使 用 数组 切片 语法 访问 多 维 数组 中 的 元 素 


为 什么 使 用 元 组 作为 下 标 

Python 的 下 标语 法 (用 [] 存 取 序列 中 的 元 素 ) 本 身 并 不 支持 多 维 , 但 是 由 于 可 以 使 用 任何 对 
象 作为 下 标 ， 因 此 Numpy 使 用 元 组 作为 下 标 存 取 数 组 中 的 元 素 ， 使 用 元 组 可 以 很 方便 地 表 
示 多 个 轴 的 下 标 。 虽然 在 Python 程序 中 , 经 常用 圆 括号 将 元 组 的 元 素 括 起 来 , 但 其 实 元 组 的 
语法 只 需要 用 去 号 隔 开元 素 即 可 ,例如 “x,y=y,x” 就 是 用 元 组 交换 变量 值 的 一 个 例子 。 因 此 
a[1,2] 和 a[(1,2)] 完 全 相同 ， 都 是 使 用 元 组 (1,2) 作 为 数组 a 的 下 标 。 


读者 也 许 会 对 如 何 创建 图 2-1 中 的 二 维 数组 感到 好 奇 。 它 实际 上 是 一 个 加 法 表 ， 由 纵向 量 


(0, 10, 20, 30, 40, 50) 和 横向 量 (0, 1, 2, 3, 4, 5) 的 元 素 相 加 而 得 。 可 以 用 下 面 的 语句 创建 它 ， 至 于 


其 原理 ， 将 在 后 面 的 章节 进行 介绍 。 


>>> a = np.arange(@, 60, 10).reshape(-1, 1) + np.arange(86，6) 
>>> a 
array([[ 0, 1, 2, 3, 4, 5]; 
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[30, 31, 32, 33, 34, 35], 

[40, 41, 42, 43, 44, 45], 

[50, 51, 52, 53, 54, 55]]) 


2-1 中 的 下 标 都 是 含有 两 个 元 素 的 元 组 ， 其 中 第 0 个 元 素 与 数组 的 第 0 轴 ( 纵 轴 
而 第 1 个 元 素 与 数组 的 第 1 轴 ( 横 轴 ) 对 应 。 下 面 是 图 中 各 种 多 维 数组 切片 的 运算 结果 ; 


>>> a[86,3:5] 
array([3，4]) 
>>> a[4:,4:] 
array([[44，45]， 
[54，55]]) 
>>> a[:,2] 
array([ 2，12，22，32，42，52]) 
S22 2 
array([[28, 22, 24], 
[40, 42, 44]]) 


) 对 应 ， 


如 果 下 标 元 组 中 只 包含 整数 和 切片 ， 那 么 得 到 的 数组 和 原始 数组 共享 数据 ， 它 是 原 数组 的 


视图 。 下 面 的 例子 中 ， 数 组 b 是 a 的 视图 ， 它 们 共享 数据 ， 因 此 修改 b[0] 时 ， 数 组 a 
元 素 也 被 修改 : 


>>> b = a[6,3:5] 
>>> b[86] = -b[e] 
>>> a[@, 3:5] 

array([-3， 4]) 


因为 数组 的 下 标 是 一 个 元 组 ， 所 以 我 们 可 以 将 下 标 元 组 保存 起 来 ,用 同一 个 元 组 存 取 多 个 


数组 : 


>>> idx = slice(None, None, 2), slice(2,None) 
>>> a[idx] # 和 a[::2,2:] 相 同 
array([[ 2, -3, 4, 5], 

[2 3235 24 2251 


对 应 的 
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[42，43，44，45]]) 
>>> a[idx][idx] # 和 a[::2,2:][::2,2:] 相 同 
array([[ 4, 5], 

[44, 45]]) 


slice 对 象 

在 [] 中 可 以 使 用 以 冒号 隔 开 的 两 个 或 三 个 整数 表示 切片 ， 但 是 单独 生成 切片 对 象 时 需要 
使 用 slice0 创 建 。 它 有 三 个 参数 ， 分 别 为 开始 值 、 结 束 值 和 间隔 步 长 ， 当 这 些 值 需要 省 略 时 
可 以 使 用 None。 例 如 ，a[slice(None,None,None),2] 和 a[:,2] 相 同 。 


用 Python 内 置 的 slice0 函 数 创 建 下 标 比较 麻烦 ， 因 此 NumpPy 提供 了 一 个 s_ 对象 来 帮助 我 
们 创建 数组 下 标 : 


Su 
(slice(None, None, 2), slice(2, None, None)) 


请 注意 s_ 实 际 上 是 一 个 mdexExpression 类 的 对 象 : 


>>> np.s_ 
<numpy.1ib.index_tricks.IndexExpression object at 8x8615693D6> 


s_ 为 什么 不 是 函数 

根据 Python 的 语法 ， 只 有 在 方 括号 “[]” 中 才能 使 用 以 冒号 隔 开 的 切片 语法 ， 如 果 s_ 
是 函数 ,那么 这 些 切 片 必须 使 用 slice0 创 建 。 类 似 的 对 象 还 有 mgrid 和 ogrid 等 , 在 后 面 的 介 
绍 中 我 们 会 学 习 它 们 的 用 法 。Python 的 下 标语 法 实际 上 会 调用 ”getitem 0 方法 ， 因 此 我 们 
可 以 很 容易 自己 实现 s 对 象 的 功能 : 


>>> class S(object): 
def _ getitem_(self, index): 
人 return index 
S37 (L2523] 
(slice(None, None, 2), slice(2, None, None)) 


在 多 维 数组 的 下 标 元 组 中 ， 也 可 以 使 用 整数 元 组 或 列表 、 整 数 数组 和 布尔 数组 。 当 在 下 标 
中 使 用 这 些 对 象 时 ， 所 获得 的 数据 是 原始 数据 的 副本 ， 因 此 修改 结果 数组 不 会 改变 原始 数组 。 
图 2-2 显示 了 如 何 使 用 各 种 序列 下 标 存 取 多 维 数组 。 


a[(8,1,2,3),(1,2,3,4)] eal 3 | 4 5 


a[3:，[9,2,5]] 


三 
mask = ep,wray((1,9,1,0,0,1), | ~ 
dtypenp.bool) 小 386 31 32 33 |34| 35 


a[mask, 2] a0 41 42 43 44 45 


图 2-2 使 用 整数 序列 和 布尔 数组 访问 多 维 数组 中 的 元 素 


>>> a[(8,1,2,3),(1,2,3,4)] © 
array([ 1, 12, 23, 34]) 
>>> a[3:, [98,2,5]] © 
array([[38, 32, 35], 
[406, 42, 45], 
[50, 52, 55]]) 
>>> mask = np.array([1,8,1,8,8,1], dtype=np.bool1) 
>>> a[mask，2] © 
array([ 2, 22, 52]) 


@ 下 标 仍然 是 一 个 含有 两 个 元 素 的 元 组 ， 元 组 中 的 每 个 元 素 都 是 一 个 整数 元 组 ， 分 别 对 应 
数组 的 第 0 轴 和 第 1 轴 。 从 两 个 序列 的 对 应 位 置 取出 两 个 整数 组 成 下 标 ， 于 是 得 到 的 结果 是 : 
a[0,1]、a[1,2]、a[2,3]、a[3,4]。 

@ 第 0 轴 的 下 标 是 一 个 切片 对 象 , 它 选取 第 3 行 之 后 的 所 有 行 ; 第 1 轴 的 下 标 是 整数 列表 ， 
它 选取 第 0、2、5 列 。 

四 第 0 轴 的 下 标 是 一 个 布尔 数组 ， 它 选取 第 0、2、5 行 ; 第 1 轴 的 下 标 是 一 个 整数 ， 选 取 
第 2 列 。 注 意 如 果 mask 不 是 布尔 数组 而 是 整数 数组 、 列 表 或 元 组 ， 就 按照 @ 的 方式 进行 运算 : 


>>> mask = np.array([1,6,1,6,9,1]) 

>>> a[mask，2] 

array([12, 2> 12, 2, 2, 12]) 

>>> mask = [True,False,True,False,False,True] 
>>> a[mask, 2] 

array([12, 2, 12,. 2; 2, 12]) 


当下 标的 长 度 小 于 数组 的 维 数 时 ， 则 剩余 的 各 轴 所 对 应 的 下 标 是 “:”， 即 选取 它们 的 所 
有 数据 : 


>>> a[[1,2]] # 与 a[[1,2],:] 相 同 
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array([[16，11，12，13，14，15]， 
【297 2 22, 23, 24, 251]) 


当 所 有 轴 都 用 形状 相同 的 整数 数组 作为 下 标 时 ， 得 到 的 数组 和 下 标 数组 的 维 数 相同 : 


>>> x = np.array([[8,1],[2,3]]) 
>>> y = np.array([[-1,-2],[-3,-4]]) 
>>> a[x,y] 
array([[ 5，14]， 

[23，32]]) 


它 的 效果 和 下 面 程序 的 相同 : 


>>> a[(@,1,2,3),(-1,-2,-3,-4)].reshape(2,2) 
array([[ 5, 14], 
[23, 32]]) 


当 没 有 指定 第 1 轴 的 下 标 时 ， 则 使 用 “:” 作 为 其 下 标 ， 因 此 得 到 了 一 个 三 维 数组 : 


>>> a[x] 

array([[[ 8@, 1, 2, 3, 4, 5], 
Lo 712 3 ST 
W200 2320 22> 23 24) 25]8 
[30, 31, 32, 33, 34, 35]]]) 


我 们 可 以 使 用 这 种 以 整数 数组 为 下 标的 方法 来 快速 替换 数组 中 的 每 个 元 素 , 例如 有 一 个 表 
示 灰 度 图 像 的 数组 image 以 及 一 个 调 色 板 数组 palette， 使 用 “palette[image]” 可 以 得 到 通过 调 
色 板 着 色 之 后 的 彩色 图 像 : 


>>> palette = np.array( [ [8,6,6]， # 调 色 板 数组 
[255,6,6]， 
[8,255,6]， 
[8,8,255], 
eS [255,255,255] ] ) 
>>> image = np.array( [ [ 8, 1, 2, 8 ]， # 图 像 数 组 
Ee Bosman ey 
>>> palette[image] 
array([[[ 8, 6， 9]， 
[2553 100] 
[0 
[ @, ©@, ©]], 
[[ @, ©@, 9], 
Lo on 255] 
[255, 255, 255], 
Leollly 


2.1.4 ”结构 数组 


在 C 语言 中 可 以 通过 struct 关键 字 定 义 结构 类 型 ， 结 构 中 的 字段 占据 连续 的 内 存 空间 。 类 
型 相同 的 两 个 结构 体 所 占用 的 内 存 大 小 相同 ， 因 此 可 以 很 容易 定义 结构 数组 。 和 C 语言 一 样 ， 
在 Numpy 中 也 很 容易 对 这 种 结构 数组 进行 操作 。 只 要 Numpy 中 的 结构 定义 和 C 语言 中 的 结构 
定义 相同 ， 就 可 以 很 方便 地 读 取 C 语言 的 结构 数组 的 二 进 制 数据 ， 将 其 转换 为 NumpPy 的 结构 
数组 。 

假设 需要 定义 一 个 结构 数组 ， 它 的 每 个 元 素 都 有 name、age 和 weight 字段 。 在 NumpPy 中 
可 以 如 下 定义 : 


5 pa numpy_struct_array.py 
总 用 Numpy 将 一 个 结构 数组 写 入 文件 中 


persontype = np.dtype({ © 
'names':['name', 'age', 'weight'], 
'formats':['S32','i', 'f']}, align= True ) 

a = np.array([("Zhang",32,75.5), ("Wang",24,65.2)], © 
dtype=persontype) 


@ 先 创建 一 个 dtype 对 象 persontype, 它 的 参数 是 一 个 描述 结构 类 型 的 各 个 字段 的 字典 。 字 
典 有 两 个 键 : names' 和 'formats'。 每 个 键 对 应 的 值 都 是 一 个 列表 。mames' 定 义 结构 中 每 个 字段 的 
名 称 ， 而 'formats' 则 定义 每 个 字段 的 类 型 。 这 里 使 用 类 型 字符 串 定义 字段 类 型 : 

e 'S32' : 长 度 为 32 字 节 的 字符 串 类 型 ， 由 于 结构 中 每 个 元 素 的 大 小 必须 固定 ， 因 此 需 

要 指定 字符 串 的 长 度 。 

e T 炎 : 32 bit 的 整数 类 型 ， 相 当 于 np.int32。 

e 中: 32 bit 的 单 精度 浮 点 数 类 型 ， 相 当 于 np.float32。 

@ 然 后 调用 array0 创 建 数组 , 通过 dtype 参数 指定 所 创建 数组 的 元 素 类 型 为 persontype。 运 
行 上 面 程序 之 后 ， 可 以 在 IPython 中 执行 如 下 语句 来 查看 数组 a 的 元 素 类 型 : 


>>> run numpy_struct_array.py 
>>> a.dtype 
dtype([(‘name’, '|S32'), (‘age'’, ‘<i4'), ("weight', '<f4')]) 


这 里 我 们 看 到 了 另外 一 种 描述 结构 类 型 的 方法 : 一 个 包含 多 个 元 组 的 列表 ， 其 中 形 如 ( 字 
段 名 ,类 型 描述 ) 的 元 组 描述 了 结构 中 的 每 个 字段 。 类 型 字符 串 前 面 的 }、'<、> 等 字符 表示 字 
段 值 的 字 节 顺序 : 

。 |: 忽视 字 节 顺序 

。 <: 低位 字 节 在 前 ， 即 小 端 模式 (little endian) 

。 > : 高 位 字 节 在 前 ， 即 大 端 模式 (big endian) 
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结构 数组 的 存 取 方 式 和 一 般 数 组 相同 ， 通 过 下 标 能 够 取得 其 中 的 元 素 ， 注 意 元 素 的 值 看 上 
去 像 是 元 组 ， 实 际 上 它 是 一 个 结构 : 


>>> a[e] 

('Zhang', 32, 75.5) 

>>> a[8@] .dtype 

dtype([('name'’, '|S32'), ('age', '<i4'), ("weight', '<f4')]) 


可 以 使 用 字段 名 作为 下 标 获取 对 应 的 字段 值 : 


>>> a[6]["name"] 
"Zhang ” 


a[0] 是 一 个 结构 元 素 ， 它 和 数组 a 共享 内 存 数据 ， 因 此 可 以 通过 修改 它 的 字段 ， 改 变 原始 
数组 中 对 应 元 素 的 字段 : 


>>> c¢ = a[1] 

>>> c["name"] = "Li" 
>>> a[1]["name"] 
Li" 


不 但 可 以 获得 结构 元 素 的 某 个 字段 ， 而 且 可 以 直接 获得 结构 数组 的 字段 ， 它 返回 的 是 原始 
数组 的 视图 ， 因 此 下 面 的 程序 可 以 通过 修改 b[0] 改 变 a[0]["age"]: 


>>> b=a["age"] 
>>> b 
array([32，24]) 
>>> b[86] = 46 
>>> a[e]["age"] 
46 


通过 atosting0 或 atofile0 方 法 ,可 以 将 数组 a 以 二 进 制 的 方式 转换 成 字符 串 或 者 写 入 文 
件 中 : 


>>> a.tofile("test.bin") 
利用 下 面 的 C 语言 程序 可 以 将 “test.bin” 文 件 中 的 数据 读 取 出 来 。 


a read_struct_array.c 
用 C 语言 读 取 Numpy 输出 的 结构 数组 文件 


#include <stdio.h> 


struct person 


char name[32]; 
int age; 
float weight; 

}; 

struct person p[3]; 

void main () 

{ 
FILE *fp; 
nt 
fp=fopen("test.bin", "rb"); 
fread(p, sizeof(struct person), 2, fp); 
fclose(fp); 
for(i=6;i<2;i++) 


printf("%s %d %f\n"，p[i].name，p[i].age，p[i].weight); 


内 存 对 齐 

为 了 内 存 寻 址 方便 ，C 语言 的 结构 体会 自动 添加 一 些 填充 用 的 字 节 ， 这 叫 内 存 对 齐 。 例 
如 ， 如 果 把 上 面 C 语言 所 定义 结构 体 中 的 字段 name[32] 改 为 name[30]， 由 于 内 存 对 齐 问题 ， 在 
name 和 age 中 间 会 填补 两 个 字 节 , 最 终 的 结构 体 的 大 小 不 会 发 生 改 变 。 因 此 如 果 数 组 中 配置 
的 内 存 大 小 不 符合 C 语言 的 对 齐 规范 , 将 会 出 现 数据 错位 。 为 了 解决 这 个 问题 , 在 创建 type 
对 象 时 ， 可 以 传递 参数 align=True， 这 样 结构 数组 的 内 存 对 齐 就 和 C 语言 的 结构 体 一 致 了 。 


结构 类 型 中 可 以 包括 其 他 的 结构 类 型 ， 下 面 的 语句 创建 一 个 含有 一 个 字段 全 的 结构 ， 全 
的 值 是 另外 一 个 结构 ， 它 含有 字段 刀 ， 其 类 型 为 16 bit 整数 。 


>>> np.dtype([('f1', [('f2', np.int16)])]) 
dtype([('f1', [('f2', '<i2°')])]) 


当 某 个 字段 的 类 型 为 数组 时 ， 用 元 组 的 第 三 个 参数 表示 其 形状 。 在 下 面 的 结构 体 中 , 人 l 字 
段 是 一 个 形状 为 (2.3) 的 双 精 度 浮 点 数组 : 


>>> np.dtype([('fe', "i4'), ('f1', 'f8', (2, 3))]) 
dtype([('fe', '<i4'), ('f1', ‘<f8', (2, 3))]) 


用 下 面 的 字典 参数 也 可 以 定义 结构 类 型 ,字典 的 键 为 结构 中 的 字段 名 ， 值 为 字段 的 类 型 描 
述 ,但 是 由 于 字典 的 键 是 没有 顺序 的 ， 因 此 字段 的 顺序 需要 在 类 型 描述 中 给 出 。 类 型 描述 是 一 
个 元 组 ， 它 的 第 二 个 值 给 出 字段 的 以 字 节 为 单位 的 偏 移 量 ， 例 如 下 例 中 的 age 字段 的 偏 移 量 为 
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25 个 字 节 : 


>>> np.dtype({'surname':('S25',8),'age':(np.uint8,25)}) 
dtype([('surname', '|S25'), ("age’, ‘|u1')]) 


使 用 字段 的 地 址 偏 移 量 可 以 定义 内 存 地 址 不 连续 的 字段 , 在 读 取 复杂 的 C 语言 结构 体 中 的 
部 分 字段 时 这 种 方式 十 分 有 效 。 


2.1.5 ”内存 结 构 


下 面 让 我 们 看 看 数组 对 象 是 如 何在 内 存 中 存储 的 。 如 图 2-3 所 示 ， 数 组 的 描述 信息 保存 在 
一 个 数据 结构 中 ， 这 个 结构 引用 两 个 对 象 : 用 于 保存 数据 的 存储 区 域 和 用 于 描述 元 素 类 型 的 
dtype 对 象 。 


ndarray 数 握 结 构 


float32 描 述 数 组 的 元 素 类 型 
deypo . float32 
sin count 党 
digensions | 3 3 
数据 存储 区 域 
mrides | 12 | 4 sbytes 
data © e@|I1|2 ] 31148168 二 攻 ， | 
一 一 


2-3 ndarray 数组 对 象 在 内 存 中 的 存储 方式 


数据 存储 区 域 保存 着 数组 中 所 有 元 素 的 二 进 制 数 据 ，dtype 对 象 则 知道 如 何 将 元 素 的 二 进 
制 数据 转换 为 可 用 的 值 。 数 组 的 维 数 和 形状 等 信息 都 保存 在 ndarray 数组 对 象 的 数据 结构 中 。 
2-3 中 显示 的 是 下 面 的 数组 a 的 内 存 结构 : 


>>> a = np.array([[98,1,2],[3,4,5],[6,7,8]], dtype=np.float32) 


数组 对 象 使 用 其 strides 属性 保存 每 个 轴 上 相 邻 两 个 元 素 的 地 址 差 , 即 当 某 个 轴 的 下 标 增加 
1 时 ， 数 据 存储 区 域 指针 所 增加 的 字 节 数 。 例 如 图 2-3 中 的 strides 为 (12.4)， 即 第 0 轴 的 下 标 增 
加 1 时， 数据 的 地 址 增加 12 个 字 节 。 也 就 是 a[1,0] 的 地 址 比 a[0,0] 的 地 址 大 12， 正 好 是 3 个 单 
精度 浮 点 数 的 总 字 节 数 。 第 1 轴 下 标 增 加 1 时 ， 数 据 的 地 址 增加 4 个 字 节 ， 正 好 是 一 个 单 精 度 
浮 点 数 的 字 节 数 。 

如 果 strides 属性 中 的 数值 正好 和 对 应 轴 所 占据 的 字 节 数 相同 , 那么 数据 在 内 存 中 是 连续 存 
储 的 。 通过 切片 下 标 得 到 的 新 数组 是 原始 数组 的 视图 ， 即 它 和 原始 数组 共享 数据 存储 区 域 ， 但 
是 新 数组 的 strides 属性 和 data 属性 会 发 生变 化 : 


> b= [2 252] 
>>> b 
array([[ 9.，2.]， 
[ 6.， 8.]]，dtype=float32) 
>>> b.strides 
(24，8) 


由 于 数组 b 和 数组 a 共享 数据 存储 区 域 , 而 数组 b 中 的 第 0 轴 和 第 1 轴 的 元 素 都 是 从 数组 
a 中 隔 一 个 元 素 取 一 个 ， 因 此 数组 b 的 strides 变 成 了 (24.8)， 正 好 都 是 数组 a 的 两 倍 。 对 照 前 面 
的 图 2-3 很 容易 看 出 : 数据 0 和 2 的 地 址 相差 8 个 字 节 ， 而 数据 0 和 6 的 地 址 相差 24 个 字 节 。 

元 素 在 数据 存储 区 域 的 排列 格式 有 两 种 : C 语言 格式 和 Fortan 语言 格式 。 在 C 语言 中 , 多 
维 数组 的 第 0 轴 是 最 上 位 的 , 即 第 0 轴 的 下 标 增加 1 时 ,元 素 的 地 址 增加 的 字 节 数 最 多 .而 Fortan 
语言 中 的 多 维 数组 的 第 0 轴 是 最 下 位 的 ， 即 第 0 轴 的 下 标 增加 1 时， 地 址 只 增加 一 个 元 素 的 字 
节 数 。 在 NumPy 中 ， 默 认 以 C 语言 格式 存储 数据 ， 如 果 希 望 改 为 Fortan 格式 ， 只 需要 在 创建 
数组 时 ， 设 置 order 参数 为 "F" 即 可 : 


>>> c = np.array([[8,1,2],[3,4,5],[6,7,8]]，dtype=np.float32，order="F") 
>>> c.strides 
(4，12) 


了 解 了 数组 的 内 存 结构 后 ， 就 可 以 解释 使 用 数组 下 标 获取 数据 时 的 复制 和 引用 问题 ; 

e ”当下 标 使 用 整数 和 切片 时 ， 获 取 的 数据 在 数据 存储 区 域 中 是 等 间隔 分 布 的。 由 于 只 
需要 修改 图 2-3 所 示 数 据 结构 中 的 dim count、dimensions、stride 等 属性 以 及 指向 数 
据 存储 区 域 的 指针 data, 就 能 实现 整数 和 切片 下 标 , 因此 新 数组 和 原始 数组 能 够 共享 
数据 存储 区 域 。 

。 当 使 用 整数 序列 、 整 数 数组 和 布尔 数组 时 ， 不 能 保证 获取 的 数据 在 数据 存储 区 域 是 
等 间隔 的 ， 因 此 无 法 和 原始 数组 共享 数据 ， 只 能 对 数据 进行 复制 。 

数组 的 flags 属性 描述 了 数据 存储 区 域 的 一 些 属性 ， 直 接 查 看 flags 属性 将 输出 各 个 标识 

的 值 : 

>>> a.flags 

C_CONTIGUOUS : True 

F_CONTIGUOUS : False 

OWNDATA : True 

WRITEABLE : True 

ALIGNED : True 

UPDATEIFCOPY : False 


也 可 以 单独 获得 其 中 的 某 个 标识 的 值 : 


>>> a.flags.c_contiguous 
True 
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几 个 比较 重要 的 标识 的 含义 如 下 : 

e C_CONTIGUOUS: 数据 存储 区 域 是 否 是 C 语言 格式 的 连续 区 域 。 

e F_ CONTIGUOUS: 数据 存储 区 域 是 否 是 Fortan 语言 格式 的 连续 区 域 。 

e OWNDATA: 数组 是 否 拥有 此 数据 存储 区 域 ， 当 数组 是 其 他 数组 的 视图 时 ， 它 不 拥 
有 数据 存储 区 域 。 

由 于 数组 a 是 通过 array0 直 接 创建 的 ， 因 此 它 的 数据 存储 区 域 是 C 语言 格式 的 连续 区 域 ， 

并 且 它 拥有 数据 存储 区 域 。 下 面 我 们 看 看 数组 a 的 转 置 数组 的 标识 : 


>>> a.T.flags 
C_CONTIGUOUS : False 
F_CONTIGUOUS : True 
OWNDATA : False 


数组 的 转 置 可 以 通过 其 了 属性 获得 , 转 置 数组 将 其 数据 存储 区 域 看 作 Fortan 语言 格式 的 连 
续 区 域 ， 并 且 它 不 拥有 数据 存储 区 域 。 


>>> b.flags 
C_CONTIGUOUS : False 
F_CONTIGUOUS : False 
OWNDATA : False 


由 于 数组 b 是 数组 a 的 一 个 视图 ， 因 此 它 既 不 拥有 数据 存储 区 域 ， 它 的 数据 也 不 是 连续 存 
储 的 。 通 过 视图 数组 的 base 属性 可 以 获得 保存 数据 的 原始 数组 : 

>>> id(b.base) 

34864768 

>>> id(a) 

34664766 

除了 使 用 切片 从 同一 块 数据 区 域 创建 不 同 的 shape 和 strides 的 数组 对 象 之 外 ， 我 们 还 可 以 

直接 设置 这 些 属 性 ， 从 而 得 到 用 切片 实现 不 了 的 效果 ， 例 如 : 


>>> from numpy.lib.stride_tricks import as_strided 
>>> a = np.arange(6) 
>>> b = as_strided(a, shape=(4, 3), strides=(4, 4)) 
>>>b 
array([[6，1，2]， 

[2 

[2, 3, 4], 

[3, 4, 5]]) 


使 用 as_stridedO 时 Numpy 不 会 进行 内 存 越界 检查 ， 因 此 如 果 shape 和 strides 设置 不 
当 ， 就 可 能 会 引起 意 想 不 到 的 错误 。 


在 上 面 这 个 例子 中 ， 我 们 从 NumPy 的 辅助 模块 中 载 入 了 一 个 as_strided0 函 数 ， 并 使 用 它 
从 一 个 长 度 为 6 的 一 维 数组 a, 创建 了 一 个 shape 为 (4.3) 的 二 维 数组 b。 由 于 通过 strides 参数 直 
接 指定 了 数组 b 的 strides 属性 ， 因 此 不 仅 数组 b 和 数组 a 共享 数据 区 域 ， 而 且 数 组 b 中 前 后 两 
行 有 两 个 元 素 是 重合 的 。 例如 下 面 修改 a[2] 的 值 , 数组 b 中 前 三 行 中 对 应 的 元 素 也 会 发 生 改变 : 


>>> a[2] = 26 

>>> b 

array([[ 6， 1，26]， 
[3 2205 3] 
[20, 3, 4], 
Uses SI 


在 对 数据 进行 处 理 时 ， 可 能 经 常 需要 对 数据 进行 分 块 处 理 ， 而 且 为 了 保持 平滑 ， 每 块 数据 
之 间 需 要 有 一 定 的 重 又 部 分 。 这 时 可 以 使 用 上 面 介绍 的 方法 对 数据 进行 带 重 又 的 分 块 。 


2.2 ”ufunc 运算 


ufunc 是 universal function 的 缩写 , 它 是 一 种 能 对 数组 中 每 个 元 素 进行 操作 的 函数 。 NumPy 
内 置 的 许多 ufine 函数 都 是 在 C 语言 级 别 实现 的 ， 因 此 它们 的 计算 速度 非常 快 。 让 我 们 先 看 一 
个 例子 : 


>>> x = np.linspace(86，2*#xnp.pi，16) 

>>> y = np.sin(x) 

>>> y 

array([。”6.66666666e+69， ”6.42787616e-61， 9.84867753e-61， 
8.66625464e-61， 3.42626143e-61， -3.42626143e-61， 
-8.66625464e-91， -9.84867753e-61， -6.42787616e-61， 
-2.44921271e-16]) 


先 用 linspace0 产 生 一 个 从 0 到 2 的 等 差 数 组 ， 然 后 将 其 传递 给 np.sin0 函 数 计算 每 个 元 
素 的 正弦 值 。 由 于 np.sin0 是 一 个 ufunc 函数 ， 因 此 在 其 内 部 对 数组 x 的 每 个 元 素 进行 循环 ， 分 
别 计算 它们 的 正弦 值 ， 并 返回 一 个 保存 各 个 计算 结果 的 数组 。 运 算 之 后 数组 x 中 的 值 并 没有 改 
变 ， 而 是 新 创建 了 一 个 数组 来 保存 结果 。 也 可 以 通过 out 参数 指定 计算 结果 的 保存 位 置 。 因 此 
如 果 希 望 直接 在 数组 x 中 保存 结果 ， 可 以 将 它 传递 给 out 参数 : 


>>> t = np.sin(x,out=x) 

$3 

array([ 8.600060000e+060, ”6.42787616e-61， ”9.84867753e-61， 
8.66625464e-61， 3.42626143e-61， -3.42626143e-61， 
-8.66625464e-81， -9.84897753e-81， -6.42787616e-61， 
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-2.44921271e-161) 
>>> id(t) == id(x) 
True 


ufime 函数 的 返回 值 仍 然 是 计算 的 结果 ， 只 不 过 它 就 是 数组 x, 因此 两 个 数组 的 id 是 相同 的 。 
下 面 比较 np.sin 和 Python 标准 库 中 math.sin 的 计算 速度 : 


s A# numpy_speed test.py 
窟 ”NumpPy 计算 和 Python 标准 库 的 计算 速度 比较 


import time 
import math 
import numpy as np 


x= [i * 8.681 for i in xrange(19666669)] 
start = time.clock() 
for i, t in enumerate(x): 

x[i] = math.sin(t) 
print“math.sin:"，time.clock() - start 


x= [i * 6.861 for i in xrange(1666666)] 
x = np.array(x) 
start = time.clock() 
np.sin(x,x) 
print “numpy.sin:", time.clock() - start 
x= [i * 8.601 for i in xrange(1996666)] 
start = time.clock() 
for i, t in enumerate(x): 
x[i] = np.sin(t) 
print "numpy.sin loop:", time.clock() - start 


程序 的 输出 为 : 


math.sin: 8.779217749742 
numpy.sin: 8.0772958574344 
numpy.sin loop: 5.25546843878 


可 以 看 出 np.sin 比 math.sin 快 10 倍 多 ， 这 得 益 于 np.sin 在 C 语言 级 别 的 循环 计算 。 
列表 推导 式 比 循环 更 快 


事实 上 ,标准 Python 中 有 比 for 循环 更 快 的 方案 一 使 用 列表 推导 式 。 但 是 列表 推导 式 
将 产生 一 个 新 的 列表 ， 而 不 是 直接 修改 原来 列表 中 的 元 素 。 下 面 的 语句 执行 时 ， 将 计算 出 一 


个 新 的 列表 来 保存 每 个 正弦 值 : 


>>> x = [math.sin(t) for t in x] 


np.sin 同样 也 支持 计算 单个 数值 的 正弦 值 。 不 过 值得 注意 的 是 , 对 单个 数值 的 计算 math.sin 
要 比 np.sin 快 很 多 。 在 Python 级 别 进行 循环 时 ，np.sin 的 计算 速度 只 有 math.sin 的 1/6。 这 是 因 
为 np.sin 为 了 同时 支持 数组 和 单个 数值 的 计算 ， 其 C 语言 的 内 部 实现 要 比 math.sin 复杂 得 多 。 
此 外 ， 对 于 单个 数值 的 计算 ，np.sin 的 返回 值 类 型 和 math.sin 的 不 同 ，math.sin 返回 的 是 Python 
的 标准 float 类 型 ， 而 np.sin 返回 的 是 float64 类 型 : 


>>> type(math.sin(8.5)) 
<type “float "> 

>>> type(np.sin(9.5)) 
<type “numpy.float64 "> 


通过 下 标 获 取 的 数组 元 素 的 类 型 为 NumPy 中 定义 的 类 型 。 将 其 转换 为 Python 的 标准 类 型 
还 需要 花费 额外 的 时 间 。 为 了 解决 这 个 问题 ， 数 组 提供 了 item0 方 法 ， 用 来 获取 数组 中 的 单个 
元 素 ， 并 直接 返回 标准 的 Python 数值 类 型 : 


>>> a = np.arange(6.6).reshape(2,3) 

>>> a.item(1,2) # 和 a[1,2] 类 似 

5.6 

>>> type(a.item(1,2)) # item() 返 回 的 是 Python 的 标准 float 类 型 
<type “float "> 

>>> type(a[1,2]) # 下 标 方式 返回 的 是 NumPy 的 float64 类 型 

<type “numpy.float64 "> 


通过 上 面 的 例子 我 们 了 解 了 如 何 最 有 效率 地 使 用 math 库 和 NumpPy 中 的 数学 函数 。 由 于 它 
们 各 有 优 缺 点 ， 因 此 在 导入 时 不 建议 使 用 “import* ”全 部 载 入 ， 而 是 应 该 使 用 “importnumpy 
asnp” 载 入 ， 这 样 可 以 根据 需要 选择 合适 的 函数 。 


2.2.1 四 则 运算 
NumpPy 提供 许多 ufunc 函数 ， 例 如 计算 两 个 数组 之 和 的 add0 函 数 : 


>>> a = np.arange(8,4) 
>>> a 

array([90, 1, 2, 3]) 
>>> b = np.arange(1,5) 
>>>b 

array([1, 2, 3, 4]) 
>>> np.add(a,b) 
array([1, 3; 5, 7]) 
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>>> np.add(a,b,a) 
array([1, 3, 5, 7]) 


>>> a 


array([1, 3, 5, 7]) 


add0 返 回 一 个 数组 ， 数 组 的 每 个 元 素 都 是 两 个 参数 数组 中 对 应 元 素 之 和 。 如 果 没 有 指定 
out 参数 ， 那 么 将 创建 一 个 新 的 数组 来 保存 计算 结果 。 如 果 指 定 了 第 三 个 参数 out， 就 不 产生 新 
的 数组 ， 而 是 直接 将 结果 保存 到 指定 的 数组 中 。 

Numpy 为 数组 定义 了 各 种 数学 运算 操作 符 ， 因 此 计算 两 个 数组 相 加 可 以 简单 地 写 为 atb， 
而 np.add(a,b,a) 则 可 以 用 at+=b 表示 。 表 2-1 列 出 了 数组 的 运算 符 及 其 对 应 的 ufunc 函数 ， 注 意 
除 号 "" 的 意义 根据 是 否 激活 ”ture _.division 会 有 所 不 同 。 


运算 符 
y=xl+x2 
y=Xl-X2 
y=xl*x2 


表 2-1 数组 的 运算 符 及 其 对 应 的 ufunc 函数 
对 应 的 ufunc 函数 
add(x1. x2[. yD) 
subtract(x1, x2 [, y) 
multiply (x1, x2 [yD) 


divide (x1, x2 [. y]), 如 果 两 个 数组 的 元 素 为 整数 ， 那 么 用 整数 除法 


y=x1l/x2 
y=xl/x2 
y=x1//x2 


y= 


true_divide (x1, x2 [, y]), 总 是 返回 精确 的 商 
floor_divide (x1, x2[,y]). 总 是 对 返回 值 取 整 
negative(x [.y]) 


powerGxl.x2 [.y) 
remainder(x1, x2 [, yj) 或 mod(x1, x2, [. yD) 


Y= 
y=xl %x2 


数组 对 象 支持 操作 符 ， 极 大 地 简化 了 表达 式 的 编写 。 不 过 要 注意 : 如果 表 达 式 很 复杂 ， 并 
且 要 运算 的 数组 很 大 ， 将 会 因为 产生 大 量 的 中 间 结 果 而 降低 程序 的 运算 效率 。 例 如 ， 假 设 对 a、 
b、c 三 个 数组 采用 表达 式 “x=a*b+c” 进 行 计算 ， 那 么 这 个 表达 式 相当 于 : 


t=a*b 
x=t+c 


del 七 


也 就 是 说 ， 需 要 产生 一 个 临时 数组 t 来 保存 乘法 的 运算 结果 ， 然 后 再 产生 最 后 的 结果 数组 
x。 可 以 将 表达 式 分 解 为 下 面 的 两 行 语句 ， 以 减少 一 次 内 存 分 配 : 


x= a*b 
X += < 


2.2.2 ”比较 和 布尔 运算 


使 用 “一 ”、“>” 等 比较 运算 符 对 两 个 数组 进行 比较 ， 将 返回 一 个 布尔 数组 ， 它 的 每 个 
元 素 值 都 是 两 个 数组 对 应 元 素 的 比较 结果 。 例 如 : 


>>> np.array([1,2,3]) < np.array([3,2,1]) 
array([ True, False, False], dtype=bool1) 


每 个 比较 运算 符 都 与 一 个 ufunc 函数 对 应 ， 下 面 是 比较 运算 符 与 其 ufune 函数 的 对 照 表 : 
表 2-2 比较 运算 符 及 其 对 应 的 ufunc 函数 


比较 运算 符 ufunc 函数 
y=x—2 | equall.2[ WD 
y=xl !=x2 | not equal(x1, x2 [, y) 
y=xl<x2 less(x1., x2, [. y) 
y=xl <=X2 less equal(x1. x2., [. y) 
y=x1>x2 greater(x1, x2., [, y) 
y=x1>=x2 greater equal(x1, x2, [, y) 


由 于 Python 中 的 布尔 运算 使 用 and、or 和 not 等 关键 字 ， 它 们 无 法 被 重 载 ， 因 此 数组 的 布 
尔 运算 只 能 通过 相应 的 ufime 函数 进行 。 这 些 函数 名 都 以 “logical ”开头 ， 在 IPython 中 使 用 
自动 补 全 功能 可 以 很 容易 地 找到 它们 ; 

>>> np.logical # 按 Tab 键 进行 自动 补 全 

np.logical and np.logical not np.logical or np.logical_ xor 


下 面 是 一 个 使 用 logical_or0 进 行 或 运算 的 例子 : 


>>> a = np.arange(5) 

>>> b = np.arange(4, -1,-1) 

>>> a == 

array([False，False， True，False，False]，dtype=bool) 
>>> a > b 

array([False, False, False, True， True] ，dtype=bool) 
>>> np.logical_or(a==b，a>b) # 和 a>=b 相同 
array([False, False, True， True， True]，dtype=bool) 


对 两 个 布尔 数组 使 用 and、or 和 not 等 进行 布尔 运算 ， 将 抛 出 ValueError 异常 。 因 为 布尔 
数组 中 有 True 也 有 False， 所 以 NumpPy 无 法 确定 用 户 的 运算 目的 : 
>>> a==b and a>b 


ValueError: The truth value of an array with more than one 
element is ambiguous. Use a.any() or a.all() 
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错误 信息 告诉 我 们 可 以 使 用 数组 的 any0 或 al0 方 法 8?。 只 要 数组 中 有 一 个 值 为 Tme，any0 
就 返回 True， 而 只 有 当 数 组 的 全 部 元 素 都 为 True 时，all0 才 返回 True。 


>>> np.any(a==b) 

True 

>>> np.any(a==b) and np.any(a>b) 
True 


以 “bitwise ”开头 的 函数 是 比特 运算 函数 ， 包 括 bitwise and、bitwise_ not、bitwise or 和 
bitwise xor 等 。 也 可 以 使 用 "&"、"~"、"|" 和 "^" 等 操作 符 进行 计算 。 

对 于 布尔 数组 来 说 ， 位 运算 和 布尔 运算 的 结果 相同 。 但 在 使 用 时 要 注意 ， 位 运算 符 的 优先 
级 比比 较 运 算 符 高 ， 因 此 需要 使 用 括号 提高 比较 运算 的 运算 优先 级 。 例 如 : 


>>> (a==b) | (a>b) 
array([False, False, True, True, True] ，dtype=bool) 


整数 数组 的 位 运算 和 C 语言 的 位 运算 相同 , 在 使 用 时 要 注意 元 素 类 型 的 符号 , 例如 下 面 的 
arange0 所 创建 的 数组 的 元 素 类 型 为 32 位 符号 整数 ， 因 此 对 正 数 按 位 取 反 将 得 到 负数 。 以 整数 
0 为 例 ， 按 位 取 反 的 结果 是 0XFFFFFFFF， 在 32 位 符号 整数 中 ， 这 个 值 表 示 -1。 


>>> ~np.arange(5) 
array([-1, -2, -3, -4, -5]) 


而 如 果 对 8 位 无 符号 整数 数组 进行 位 取 反 运算 : 


>>> ~np.arange(5, dtype=np.uint8) 
array([255, 254, 253, 252, 251], dtype=uint8) 


同样 的 整数 0， 按 位 取 反 的 结果 是 0x*FF， 当 它 是 8 位 无 符号 整数 时 ， 它 的 值 是 255。 
2.2.3 自 定 义 ufunc 函数 


通过 NumPy 提供 的 标准 ufune 函数 ， 可 以 组 合 出 复杂 的 表达 式 ， 在 C 语言 级 别 对 数组 的 
每 个 元 素 进行 计算 。 但 有 时 这 种 表达 式 不 易 编写 ， 而 对 每 个 元 素 进行 计算 的 程序 却 很 容易 用 
Python 实现 ， 这 时 可 以 用 frompyfunc0 将 一 个 计算 单个 元 素 的 函数 转换 成 ufunc 函数 。 这 样 就 
可 以 方便 地 用 所 产生 的 ufunc 函数 对 数组 进行 计算 了 。 

例如 ， 我 们 可 以 用 一 个 分 段 函 数 描述 三 角 波 ， 三 角 波 的 样子 如 图 2-4 所 示 ， 它 分 为 三 段 : 
上 升 段 、 下 降 段 和 平坦 段 。 


图 在 NumPy 中 同时 也 定义 了 any0 和 all0 函 数 。 


图 2-4 三 角 波 可 以 用 分 段 函数 进行 计算 


5 # numpy_frompyfunc.py 
党 下 用 frompyfunc0 计 算 三 角 波 的 波形 数组 


根据 图 2-4， 我 们 很 容易 写 出 计算 三 角 波 上 某 点 Y 坐标 的 函数 。 显 然 triangle_waveO 只 能 
计算 单个 数值 ， 不 能 对 数组 直接 进行 处 理 。 
def triangle wave(x, c, ce, hc): 
x = x - int(x) # 三 角 波 的 周期 为 1， 因 此 只 取 x 坐标 的 小 数 部 分 进行 计算 
if x >= Cc:r=08.0 
elif x<co:ra=ax/co*hc 
else: Pr = (c-x) / (c-c@) * hc 
return r 


可 以 用 下 面 的 程序 先 使 用 列表 推导 式 计 算出 一 个 列表 ， 然 后 用 array0 将 列表 转换 为 数组 。 
这 种 做 法 每 次 都 需要 使 用 列表 推导 式 语法 调用 函数 ， 对 于 多 维 数组 是 很 麻烦 的 。 


x = np.linspace(6，2，1666) 
y1 = np.array([triangle_wave(t，6.6，6.4，1.6) for t in x]) 


通过 frompyfuncO 可 以 将 计算 单个 值 的 函数 转换 为 一 个 能 对 数组 中 每 个 元 素 进行 计算 的 
ufunc 函数 。frompyfunc0 的 调用 格式 为 : 


frompyfunc(func, nin, nout) 


其 中 ,func 是 计算 单个 元 素 的 函数 ，nin 是 func 输入 参数 的 个 数 ，nout 是 func 返回 值 的 个 
数 。 下 面 的 程序 使 用 ftompyfunc0 将 triangle_wave0 转 换 为 一 个 ufunc 函数 对 象 triangle_ufuncl: 


triangle_ufunc1 = np.frompyfunc(triangle_wave，4，1) 
y2 = triangle_ufunc1(x，6.6，6.4，1.6) 
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值得 注意 的 是 ，triangle_ufunc10 所 返回 数组 的 元 素 类 型 是 object， 因 此 还 需要 再 调用 数组 
的 astype0 方 法 以 将 其 转换 为 双 精 度 浮 点 数组 : 


>>> run numpy_frompyfunc.py # 在 IPython 中 运行 计算 三 角 波 的 程序 
>>> y2.dtype 

dtype( "object ') 

>>> y2 = y2.astype(np.float) 

>>> y2.dtype 

dtype( 'float64') 


使 用 vectorize0 可 以 实现 和 frompyfunc0 类 似 的 功能 ,但 它 可 以 通过 otypes 参数 指定 返回 数 
组 的 元 素 类 型 。otypes 参数 可 以 是 一 个 表示 元 素 类 型 的 字符 串 ， 也 可 以 是 一 个 类 型 列表 ， 使 用 
列表 可 以 描述 多 个 返回 数组 的 元 素 类 型 。 下 面 的 程序 使 用 vectorize0 计 算 三 角 波 : 


triangle_ufunc2 = np.vectorize(triangle_wave，otypes=[np.float]) 
y3 = triangle_ufunc2(x, 8.6, 68.4, 1.06) 


最 后 我 们 验证 一 下 结果 : 


>>> np.all(y1==y2) 
True 
>>> np.all(y2==y3) 
True 


2.2.4 广播 


当 使 用 ufune 函数 对 两 个 数组 进行 计算 时 ，ufunc 函数 会 对 这 两 个 数组 的 对 应 元 素 进 行 计 
算 ， 因 此 要 求 这 两 个 数组 的 形状 相同 。 如 果 形状 不 同 ， 会 进行 如 下 的 广播 (broadcasting) 处 理 : 

(1) 让 所 有 输入 数组 都 向 其 中 维 数 最 多 的 数组 看 齐 , shape 属性 中 不 足 的 部 分 都 通过 在 前 面 
加 1 补 齐 。 

CO) 输出 数组 的 shape 属性 是 输入 数组 的 shape 属性 在 各 个 轴 上 的 最 大 值 。 

(3) 如 果 输入 数组 的 某 个 轴 长 度 为 1 或 与 输出 数组 对 应 轴 的 长 度 相同 ， 这 个 数组 就 能 够 用 
来 计算 ， 否 则 出 错 。 

(4) 当 输 入 数组 的 某 个 轴 长 度 为 1 时 ， 沿 着 此 轴 运 算 时 都 用 此 轴 上 的 第 一 组 值 。 

上 述 4 条 规则 理解 起 来 可 能 比较 费劲 ， 下 面 让 我 们 看 一 个 实际 的 例子 。 

先 创建 一 个 二 维 数组 a， 其 形状 为 (6,1): 


>>> a = np.arange(0, 60, 10).reshape(-1, 1) 
>>> a 

array([[ 8], [10], [28], [30], [49], [58]]) 
>>> a.shape 

(6, 1) 


再 创建 一 维 数组 b， 其 形状 为 (5,): 


>>> b = np.arange(6，5) 
>>> b 
array([6，1，2，3，4]) 
>>> b.shape 


(5,) 


计算 数组 a 和 b 的 和 ， 得 到 一 个 加 法 表 ， 它 相当 于 计算 两 个 数组 中 所 有 元 素 组 的 和 ， 得 到 
一 个 形状 为 (6,5) 的 数组 : 


9 nt 

IE 

array([[ 8, 1, 2, 3, 4], 
La8, 11, 12, 13, 14], 
[20; 21; 22; 2335°24]5 
L390, 31, 32; 33; 34]， 
[46, 41, 42, 43, 44], 
[L505 515. 52 535. 54]]) 

>>> c.shape 

(6, 5) 


由 于 数组 a 和 的 维 数 不 同 ， 根 据 规则 (1)， 需 要 让 数组 b 的 shape 属性 向 数组 a 对 齐 ， 于 
是 将 数组 b 的 shape 属性 前 面 加 1， 补 齐 为 (1,5)。 相 当 于 做 了 如 下 计算 : 


>>> b.shape=1,5 
>>>b 
array([[6，1，2，3，4]]) 


这 样 一 来 ， 做 加 法 运算 的 两 个 输入 数组 的 shape 属性 分 别 为 (6,1) 和 (1,5)， 根 据 规则 (2)， 输 
出 数组 各 个 轴 的 长 度 为 输入 数组 各 个 轴 长 度 的 最 大 值 ， 可 知 输出 数组 的 shape 属性 为 (6.5)。 

由 于 数组 b 第 0 轴 的 长 度 为 1， 而 数组 a 第 0 轴 的 长 度 为 6， 因此 为 了 让 它们 在 第 0 轴 上 
能 够 相 加 ， 需 要 将 数组 b 第 0 轴 的 长 度 扩展 为 6， 这 相当 于 : 


>>> b = b.repeat(6,axis=6) 
>>> b 
array([[6，1，2，3，4]， 
[@, 1, 2, 3, 4], 
[e, 1, 2 
[8，1，2 
[@, 1, 2, 3, 4], 
[8，1，2 
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于 数组 a 第 1 轴 的 长 度 为 1， 而 数组 b 第 1 轴 的 长 度 为 5， 因 此 为 了 让 它们 在 第 1 轴 上 
能 够 相 加 ， 需 要 将 数组 a 第 1 轴 的 长 度 扩展 为 5， 这 相当 于 : 


>>> a = a.repeat(5, axis=1) 

>>> a 

may(ll'0 0 en 0; 9]> 
[10, 10, 10, 10, 10], 
[20, 20, 20, 20, 20], 
[30, 30, 30, 306, 38], 
[40, 406, 40, 40,496]， 
L50507 .50 59) 501] 


经 过 上 述 处 理 之 后 ， 数 组 a 和 b 就 可 以 按 对 应 元 素 进行 相 加 运算 了 。 

当然 , 在 执行 “atb” 运 算 时 , NumPy 内 部 并 不 会 真正 将 长 度 为 1 的 轴 用 repeat0 进 行 扩展 ， 
这 样 太 浪费 空间 了 。 

由 于 这 种 广播 计算 很 常用 ， 因 此 NumPy 提供 了 快速 产生 能 进行 广播 运算 的 数组 的 ogrid 
对 象 。 


>>> x,y = np.ogrid[:5,:5] 
> 


array([[8],[1],[2],[3],[4]]) 
>>> y 
array([[6，1，2，3，4]]) 


mgrid 对 象 的 用 法 和 ogrid 对 象 类 似 ， 但 是 它 所 返回 的 是 进行 广播 之 后 的 数组 。 请 读 
隔 者 运行 “np msgrid[:5,:5]” 试 试看 。 


ogrid 是 一 个 很 有 趣 的 对 象 ， 它 和 多 维 数组 一 样 ， 用 切片 元 组 作为 下 标 ， 返 回 的 是 一 组 可 
以 用 来 广播 计算 的 数组 。 其 切片 下 标 有 两 种 形式 : 
e 开始 值 :结束 值 : 步 长 ， 和 “np.arange( 开 始 值 ， 结 束 值 ， 步 长 )” 类 似 。 
e 开始 值 :结束 值 :长 度 j， 当 第 三 个 参数 为 虚数 时 ， 它 表示 所 返回 数组 的 长 度 ， 其 和 
“np.linspace( 开 始 值 ,结束 值 ,长度 )” 类 似 。 


>>> x, y = np.ogrid[:1:4j, :1:3j] 
>>> x 
array([[ 9. a 
[ 6.33333333]， 
[ 8.66666667]， 
[1 ]]) 
>>> y 
Sa 人 5 


利用 ogrid 的 返回 值 ， 可 以 很 容易 计算 出 二 元 函数 在 等 间距 网 格 上 的 值 。 下 面 是 绘制 三 维 
曲面 了 (x,y) = xe ”的 程序 : 


, A# numpy_ogrid mlab.py 
合生 用 ogird 产 生 二 维 坐标 网 格 ， 计 算 三 维 空间 的 曲面 


import numpy as np 
from enthought.mayavi import mlab 


x, y = np.ogrid[-2:2:26j，-2:2:26j] 

z= Xx* np.exp( - x**2 - y**2) 

pl = mlab.surf(x, y, z, warp_scale="auto") 
mlab.axes(xlabel="'x', ylabel="'y', zlabel="'z') 
mlab.outline(p1) 

mlab.show() 


此 程序 使 用 Mayavi 的 mlab 模块 快速 绘制 如 图 2-5 所 示 的 3D 曲面 ( 见 封 二 彩 插 )， 关 于 
Mayavi 的 相关 内 容 将 在 随后 的 章节 中 进行 介绍 。 


200 

, 六 
20 中 om 
2-5 ”使 用 ogrid 创建 的 三 维 曲面 


如 果 已 经 有 了 多 个 表示 在 不 同 轴 上 取 值 的 一 维 数组 , 并 且 想 计算 出 由 它们 所 构成 网 格 上 的 
每 点 的 函数 值 ， 那 么 可 以 使 用 ix_0: 


>>> x = np.array([6，1，4，16]) 
>>> y = np.array([2, 3, 8]) 
>>> gy, gx = np.ix_(y, x) 

>>> gx 

array([[ 8, 1, 4, 19]]) 

>>> gy 

array([[2], [3], [8]]) 
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>>> gx+gy # 广播 运算 

aaykl 2 3 632]。 
DS 4 7 
Le 9 2 0]]) 


在 上 面 的 例子 中 ,通过 ix_0 将 数组 x 和 y 转换 成 能 进行 广播 运算 的 二 维 数组 。 注 意 数组 y 
对 应 广播 运算 结果 中 的 第 0 轴 ， 而 数组 x 与 第 1 轴 对 应 。 


2.2.5 _ufunc 函数 的 方法 


ufime 函数 对 象 本 身 还 有 一 些 方法 ， 这 些 方法 只 对 两 个 输入 、 一 个 输出 的 ufunc 对 象 有 效 ， 
其 他 的 ufunc 对 象 调用 这 些 方法 时 会 抛 出 ValueError 异常 。 

reduce0 方 法 和 Python 的 reduce0 函 数 类 似 ， 它 沿 着 axis 参数 指定 的 轴 对 数组 进行 操作 ， 
相当 于 将 <op> 运 算 符 插入 到 沿 axis 轴 的 所 有 元 素 之 间 。 


<op>.reduce (array，axis=9，dtype=None) 
例如 : 


>>> np.add.reduce([1,2,3]) #1+2+3 

6 

>>> np.add.reduce([[1,2,3],[4,5,6]], axis=1) # (1+2+3), (4+5+6) 
array([ 6, 15]) 


accumulate0 和 reduce0 类 似 ， 只 是 它 返回 的 数组 和 输入 数组 的 形状 相同 ， 保 存 所 有 的 中 间 
计算 结果 : 


>>> np.add.accumulate([1,2,3]) 
array([1, 3, 6]) 
>>> np.add.accumulate([[1,2,3],[4,5,6]], axis=1) 
array([[ 1, 3, 6], 
L91511) 


Teduceat0 计 算 多 组 reduce0 的 结果 ， 通 过 indices 参数 指定 一 系列 的 起 始 和 终止 位 置 。 它 的 
计算 有 些 特别 ， 让 我 们 通过 例子 详细 解释 一 下 : 


>>> a = np.array([1,2,3,4]) 

>>> result = np.add.reduceat(a,indices=[6,1,9,2,9,3,8]) 
>>> result 

array([ 1, 2 3, 3, 6, 4, 19]) 


对 于 indices 参数 中 的 每 个 元 素 都 会 计算 出 一 个 值 ， 因 此 最 终 的 计算 结果 和 indices 参数 的 
长 度 相同 。 结 果 数 组 result 中 除 最 后 一 个 元 素 之 外 ， 都 按照 如 下 计算 得 出 : 


if indices[i] < indices[i+1]: 

result[i] = <op>.reduce(a[indices[i]:indices[i+1]]) 
else: 

result[i] = a[indices[i]] 


最 后 一 个 元 素 则 按照 如 下 计算 得 出 : 
<op>.reduce(a[indices[-1]:]) 
因此 上 面 例子 中 ， 数 组 result 的 每 个 元 素 都 按照 如 下 计算 得 出 : 


: ale] -> 1 

=》 

: a[6] + a[1] -> 1+ 2 

al2] =>3 

: a[le] + a[1] + a[2] -> 1+2+3=6 

:al3] -> 4 

16: a[8] + a[1] + a[2] + a[4] -> 1+2+3+4=10 


上 OOwwN 


可 以 看 出 : result[::2] 和 a 相等 ， 而 result[1::2] 和 np.add.accumulate(a) 相 等 。 使 用 reduceatO 
可 以 对 数组 中 的 多 个 片段 同时 进行 reduce 运算 。 

ufime 函数 对 象 的 outer0 方 法 对 其 两 个 参数 数组 中 每 两 对 元 素 的 组 合 进行 运算 。 如果 数组 a 
的 维 数 为 M， 数 组 b 的 维 数 为 N， 那 么 使 用 ufunc 函数 op 的 outer0 方 法 对 数组 a、b 计算 后 ， 
生成 的 数组 的 维 数 为 M+N。 数 组 c 的 形状 是 数组 a\b 形状 的 结合 。 例 如 数组 a 的 形状 为 (2,3)， 
数组 b 的 形状 为 (4,5)， 则 数组 c 的 形状 为 (2,3,4,5)。 

让 我 们 看 一 个 例子 : 


>>> np.multiply.outer([1,2,3,4,5],[2,3,4]) 
array([[ 2, 3, 4], 

La 6 Bl]s 

L6 9 12]» 

[ 8, 12, 16], 

[16，15，26]]) 


可 以 看 出 ， 通 过 outer0 计 算得 到 的 结果 是 如 下 的 乘法 表 : 


3| 6 9 12 
4| 8 12 16 
5|16 15 26 
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如 果 将 这 两 个 数组 按照 等 同 程序 一 步 一 步 地 进行 计算 , 就 会 发 现 乘 法 表 最 终 是 通过 广播 的 
方式 计算 出 来 的 。 


2.3 多维 数组 的 下 标 存 取 


在 前 面 的 介绍 中 , 我 们 通过 一 些 实例 介绍 了 如 何 对 多 维 数组 进行 下 标 访问 。 实 际 上 , NumPy 
提供 的 下 标 功能 十 分 强大 ， 在 掌握 了 “广播 ”相关 的 知识 之 后 ， 让 我 们 再 回 过 头 来 系统 地 学 习 
数组 的 下 标 规则 。 


2.3.1 下 标 对 象 


首先 ， 多 维 数组 的 下 标 应 该 是 一 个 长 度 上 与 数组 的 维 数 相 同 的 元 组 。 如 果 下 标 元 组 的 长 度 
比 数组 的 维 数 大 ， 就 会 出 错 。 如 果 小 ， 就 需要 在 下 标 元 组 的 后 面 补 “:”， 使 得 它 的 长 度 与 数组 
维 数 相同 。 

如 果 下 标 对 象 不 是 元 组 ，NumPy 会 首先 把 它 转换 为 元 组 。 这 种 转换 可 能 会 和 用 户 所 希望 
的 不 一 致 ， 因 此 为 了 避免 出 现 问题 ， 请 显 式 地 使 用 元 组 作为 下 标 。 例 如 ， 数 组 a 是 一 个 三 维 数 
组 ， 下 面 分 别 使 用 一 个 二 维 列 表 lidx 和 一 个 二 维 数组 aidx 作为 下 标 ， 得 到 的 结果 是 不 一 样 的 。 


>>> a = np.arange(3*4*5) .reshape(3,4,5) 
>>> lidx = [[8],[1],[2]] 
>>> aidx = np.array(lidx) 
>>> a[lidx] 
array([7]) 
>>> a[aidx] 
arreytlltl Os 1 2 33 4]s 
| 
[[ 省 略 ]] 


这 是 因为 NumPy 将 列表 lidx 转换 成 了 ([0].[1],[2])， 而 将 数组 aidx 转换 成 了 [aidx,:,:]; 


>>> a[tuple(lidx)] 

array([7]) 

>>> a[aidx,:,:] 

array([[[[ @, 1, 2, 3, 4], 
[三 5 .6, 7, 8, 9]， 

[[ 省 略 ]] 


经 过 各 种 转换 和 添加 “:” 之 后 ， 得 到 了 一 个 标准 的 下 标 元 组 。 它 的 各 个 元 素 有 如 下 几 种 
类 型 : 切片 、 整 数 、 整 数 数组 和 布尔 数组 。 如 果 元 素 不 是 这 些 类 型 ， 如 列表 或 元 组 ， 就 将 其 转 
换 成 整数 数组 。 


如 果 下 标 元 组 的 所 有 元 素 都 是 切片 和 整数 , 那么 用 它 作为 下 标 得 到 的 是 原始 数组 的 一 个 视 
图 ， 即 它 和 原始 数组 共享 数据 存储 空间 。 


2.3.2 ”整数 数组 作为 下 标 


下 面 让 我 们 看 看 下 标 元 组 中 的 元 素 由 切片 和 整数 数组 构成 的 情况 。 假 设 整数 数组 有 个， 
切片 有 入 ;个 。Nc+tN; 为 数组 的 维 数 D。 

首先 这 i 个 整数 数组 必须 满足 广播 条 件 ， 假 设 它们 进行 广播 之 后 的 维 数 为 M， 形 状 为 
(dod1,... ,dm 1) 。 

如 果 ;为 0， 即 没有 切片 元 素 ， 那 么 下 标 得 到 的 结果 数组 result 的 形状 和 整数 数组 广播 之 
后 的 形状 相同 。 它 的 每 个 元 素 值 可 按照 下 面 的 公式 得 出 : 


result[ipi,...sim 1 =X/indofipis,... im) ».-., ind i Lo 
其 中 indo 到 indw -1 为 进行 广播 之 后 的 整数 数组 。 让 我 们 通过 一 个 例子 加 深 对 此 公式 的 理解 : 


>>> ie = np.array([[1,2,1],[8,1,6]]) 
>>> il = np.array([[[6]],[[1]]]) 
>>> i2 = np.array([[[2,3,2]]]) 
>>> b = a[ie, i1, i2] 
>>> b 
array([[[22, 43, 22], 
[ 2, 23, 2]], 
[[27, 48, 27], 
[8 


首先 ，i0、il、i2 三 个 整数 数组 的 shape 属性 分 别 为 (2,3)、(2,1,1)、(1,1,3)， 根 据 广播 规则 ， 
先 在 长 度 不 足 3 的 shape 属性 前 面 补 1, 使 它们 的 维 数 相同 , 广播 之 后 的 shape 属性 为 各 个 轴 的 
最 大 值 : 


(1, 2, 3) 
(2, 1, 1) 
(1, 1, 3) 


即 三 个 整数 数组 广播 之 后 的 shape 属性 为 (2,2,3)， 这 也 就 是 下 标 运算 所 得 到 的 结果 数组 的 
维 数 : 


>>> b.shape 
(2, 2, 3) 


可 以 使 用 broadcast_arrays0 查 看 广播 之 后 的 数组 : 
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>>> inde, ind1, ind2 = np.broadcast arrays(ie, i1, i2) 
>>> ind@ 
array([[[1, 2, 1], 
[e, 1, 8]], 
[[1, 2, 1], 
[e, 1，96]]]) 
>>> ind1 
array([[[e, 9, 9], 
[8, 9, 8]], 
[[1, 1, 1], 
[1, 1, 1]]]) 
>>> ind2 
array([[[2, 3, 2], 
[2, 3, 2]], 
[[2, 3, 2], 
[2, 3, 2]]]) 


对 于 数组 b 中 的 任意 一 个 元 素 b[ij,k], 它 是 数组 a 中 经 过 ind0、indl 和 ind2 进行 下 标 转换 
之 后 的 值 : 


S33 4 jks ,12 

>>> b[i,j,k] 

村 

>>> a[inde[i,j,k],ind1[i,j,k],ind2[i,j,k]] 
本 

>>> ijk = 1,1,1 

>>> b[i,j,k] 

28 

>>> a[inde[i,j,k],indl[i,j,k],ind2[i,j,k]] 
28 


下 面 考虑 入; 不 为 0 的 情况 。 当 存在 切片 下 标 时 ， 情 况 就 变 得 更 加 复杂 了 。 可 以 细 分 为 两 
种 情况 ， 下 标 元 组 中 的 整数 数组 之 间 没 有 切片 ， 即 整数 数组 只 有 一 个 或 者 是 连续 的 。 这 时 结果 
数组 的 shape 属性 为 : 将 原始 数组 的 shape 属性 中 整数 数组 所 占据 的 部 分 蔡 换 为 它们 广播 之 后 
的 shape 属性 。 例如 , 假设 原始 数组 a 的 shape 属性 为 (3,4,5), i0 和 il 广播 之 后 的 形状 为 (2.2.3)， 
则 a[1:3,i0,i1] 的 形状 为 (2,2,2,3): 

>>> c=a[1:3, ie@, i1] 

>>> c.shape 

人 5 

其 中 ， 数 组 e 的 shape 属性 中 的 第 一 个 2 是 切片 “1:3” 的 长 度 ， 后 面 的 (2.2.3) 则 是 i0 和 这 
广播 之 后 数组 的 形状 : 


>>> inde, ind1 = np.broadcast_arrays(i9，il1) 

>>> inde.shape 
© R23) 

Bj 2 

>>> els52jdk] 
array([21, 41]) 

>>> a[1:3,inde[i,j,k],ind1[i,j,k]] # 和 c[:,i,j,k] 的 值 相同 
array([21，41]) 


如 果 下 标 元 组 中 的 整数 数组 不 是 连续 的 ， 那 么 结果 数组 的 shape 属性 为 整数 数组 广播 之 后 
的 形状 后 面 再 加 上 切片 元 素 对 应 的 形状 。 例 如 ，a[i0,:,il] 的 shape 属性 为 (2.2.3,.4)。 其 中 ，(2.2.3) 
是 i0 和 il 广播 之 后 的 形状 ， 而 4 是 数组 a 第 1 轴 的 长 度 : 


>>> d = a[ie, :, i1] 
>>> d.shape 
(2, 2, 3, 4) 
0 
>>y0g[5J5k 
array([ 1, 6, 11, 16]) 
>>> a[inde[i,j,k],:,indl[i,j,k]] 
array([ 1, 6, 11, 16]) 


2.3.3 一 个 复杂 的 例子 


下 面 让 我 们 用 所 学 的 下 标 存 取 的 知识 ， 解 决 在 NumPy 邮件 列表 中 提出 的 一 个 比较 经 典 的 
问题 ， 此 问题 的 原文 链接 地 址 为 : 


http://mail.scipy.org/pipermail/numpy-discussion/2008-July/035764.html 
Numpy 邮件 列表 中 的 原文 链接 


我 们 对 问题 进行 一 些 简化 , 提问 者 想 要 实现 的 下 标 运算 是 : 有 一 个 形状 为 (了 K) 的 三 维 数 
组 v 和 一 个 形状 为 (也 的 二 维 数组 idx，idx 的 每 个 值 都 是 0 到 K-L 的 整数 。 他 想 通 过 下 标 运 算 
得 到 一 个 数组 r， 对 于 第 0 轴 和 第 1 轴 的 每 个 下 标 1 和 j 都 满足 下 面条 件 : 


r[i,j,:] = v[i,j,idx[i,j]:idx[i,j]+L] 


如 图 2-6 所 示 ”， 左 图 中 不 透明 的 方块 是 我 们 希望 获取 的 部 分 ， 通 过 下 标 运 算 之 后 将 得 到 
右 图 所 示 的 数组 。 


@ 绘制 此 图 的 源 程序 为 “numpy_amray index_demopy”- 
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图 2-6 三 维 数组 下 标 运算 问题 的 示意 图 


首先 创建 一 个 方便 调试 的 数组 v， 它 在 第 2 轴 上 每 一 层 的 值 就 是 该 层 的 高 度 ， 即 v[-.: 洒 的 
所 有 元 素 的 值 都 为 1。 然后 随机 产生 数组 idx， 它 的 每 个 元 素 的 取 值 都 在 0 到 KL 之 间 : 


{numpy array index.py 
A 三 维 数组 下 标 运算 问题 


es | MN ee 
99. 2 Vpnidt:LT, 2:35 :KI 
>>> idx = np.random.randint(@, K-L, size=(I,J)) 


然后 用 数组 idx 创建 第 2 轴 的 下 标 数组 idx_ k， 它 是 一 个 形状 为 LLL) 的 三 维 数组 。 它 的 第 
2 轴 上 的 每 一 层 的 值 都 等 于 idx 数组 加 上 层 的 高 度 ， 即 “idx_k[:,:,i] =idx[:,:]+i”: 


>>> idx_k = idx.reshape(I,],1) + np.arange(L) 
>>> idx_k.shape 
(6, 7, 3) 


然后 分 别 创建 第 0 轴 和 第 1 轴 的 下 标 数组 ， 它 们 的 shape 属性 分 别 为 (L1,1) 和 (1,],1): 
>>> idx_ i, idx j, _ = np.ogrid[:I，:]，:K] 
使 用 idx_ i、idx_j、idx _k 对 数组 v 进行 下 标 运算 即 可 得 到 结果 : 


>>> r = v[idx_ i, idx j, idx_k] 

>>> i,，j = 2，3 # 验证 结果 ， 读 者 可 以 修改 为 使 用 循环 测试 
| 

array([4，5，6]) 

>>> v[i,j,idx[i,j]:idx[i,j]+L] 

array([4，5，6]) 


2.3.4 布尔 数组 作为 下 标 


当 使 用 布尔 数组 直接 作为 下 标 对 象 或 者 元 组 下 标 对 象 中 有 布尔 数组 时 ， 都 相当 于 用 
nonzero0 将 布尔 数组 转换 成 一 组 整数 数组 ， 然 后 使 用 整数 数组 进行 下 标 运算 。 

nonzeros(a) 返 回 数 组 a 中 值 不 为 零 的 元 素 的 下 标 ， 它 的 返回 值 是 一 个 长 度 为 andim( 数 组 a 
的 轴 数 ) 的 元 组 ， 元 组 的 每 个 元 素 都 是 一 个 整数 数组 ， 其 值 为 非 零 元 素 的 下 标 在 对 应 轴 上 的 值 。 
例如 ， 对 于 一 维 布尔 数组 bl，nonzero(b1) 得 到 的 是 一 个 长 度 为 1 的 元 组 ， 它 表示 bl[0] 和 bl[2] 
的 值 不 为 0(False)。 


>>> bl = np.array([True，False，True，False]) 
>>> np.nonzero(b1) 
(array([6，2])，) 


对 于 二 维 数组 bD，nonzero(b2) 得 到 的 是 一 个 长 度 为 2 的 元 组 . 它 的 第 0 个 元 素 是 数组 a 中 
值 不 为 0 的 元 素 的 第 0 轴 的 下 标 ,第 1 个 元 素 则 是 第 1 轴 的 下 标 ,因此 从 下 面 的 结果 可 知 b2[0,0]、 
b[0,2] 和 b2[1,0] 的 值 不 为 0: 


>>> b2 = np.array([[True, False, True], [True, False, False]]) 
>>> np.nonzero(b2) 
(array([6，6，1])，array([6，2，6])) 


当 布 尔 数组 直接 作为 下 标 时 ， 相 当 于 使 用 由 nonzero0 转 换 之 后 的 元 组 作为 下 标 对 象 : 


>>> a = np.arange(3*4*5) .reshape(3,4,5) 
>>> a[b2] 
array(lt en 1 2 3> 4]> 
LD ,12 39. 41 
L207 2 2 2 241) 
>>> a[np.nonzero(b2)] 
array([[ 8, 1, 2, 3, 4], 
[19; 23 125 13 214] 
L203 21 2 


当下 标 对 象 是 元 组 ， 并 且 其 中 有 布尔 数组 时 ， 相 当 于 将 布尔 数组 展开 为 由 nonzeros0 转 换 
之 后 的 各 个 整数 数组 : 


>>> a[1:3, b2] 
array([[28, 22, 25], 
[40, 42, 45]]) 
>>> a[1:3, np.nonzero(b2)[8], np.nonzero(b2)[1]] 
array([[28, 22, 25], 
[460, 42, 45]]) 
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2.4 庞大 的 函数 库 


除了 前 面 介绍 的 ndarray 数组 对 象 和 ufanec 函数 之 外 ，NumpPy 还 提供 了 大 量 对 数组 进行 处 
理 的 函数 。 充 分 利用 这 些 函 数 ， 能 够 简化 程序 的 逻辑 ， 提 高 运算 速度 。 本 节 通 过 一 些 较为 常用 
的 例子 ， 说 明 它们 的 一 些 使 用 技巧 和 注意 事项 。 


2.4.1 求 和 、 平 均值 、 方 差 


sum0 计 算数 组 元 素 之 和 ， 也 可 以 对 列表 、 元 组 等 和 数组 类 似 的 序列 进行 求 和 。 当 数组 是 
多 维 时 ， 它 计算 数组 中 所 有 元 素 的 和 : 


>>> a = np.random.randint(@,18, size=(4,5)) 
>>> a 
array([[7, 1, 9, 6, 3], 
[5, 1, 3, 8, 2], 
[9, 8, 9, 4, 98], 
[9, 5, 1, 7, 8]]) 
>>> np.sum(a) 
97 


如 果 指 定 axis 参数 ， 求 和 运算 将 沿 着 指定 的 轴 进 行 。 在 上 面 的 例子 中 , 数组 a 的 第 0 轴 长 
度 为 4, 第 1 轴 长 度 为 5。 如果 axis 参数 为 1， 就 对 每 行 上 的 5 个 数 求 和 ， 所 得 的 结果 是 长 度 为 
4 的 一 维 数组 。 如 果 参 数 axis 为 0， 就 对 每 列 上 的 4 个 数 求 和 ， 结 果 是 长 度 为 5 的 一 维 数组 。 
即 ， 结 果 数 组 的 形状 是 原始 数组 的 形状 除去 其 第 axis 个 元 素 : 


>>> np.sum(a, axis=1) 
array([26, 19, 390, 22]) 
>>> np.sum(a, axis=0) 
array([38, 15, 22, 25, 5]) 


上 面 的 例子 将 产生 一 个 新 的 数组 来 保存 求 和 结果 , 如 果 希 望 将 结果 直接 保存 到 另外 一 个 数 
组 中 ， 可 以 和 ufunce 函数 一 样 使 用 out 参数 指定 输出 数组 , 它 的 形状 必须 和 结果 数组 的 形状 
相同 。 

sum0 默 认 使 用 和 数组 的 元 素 类 型 相同 的 累加 变量 进行 计算 ， 如 果 元 素 类 型 为 整数 ， 就 使 
用 系统 的 默认 整数 类 型 作为 累加 变量 。 在 32 位 系统 中 ， 累 加 变量 的 类 型 为 32 bit 整 型。 因此 对 
整数 数组 进行 累加 时 可 能 会 出 现 溢出 问题 ， 即 数组 元 素 的 总 和 超过 了 累加 变量 的 取 值 范 围 。 而 
对 很 大 的 单 精度 浮 点 数 类 型 数组 进行 计算 时 , 也 可 能 出 现 精度 不 够 的 现象 , 这 时 可 以 通过 dtype 
参数 指定 累加 变量 的 类 型 。 在 下 面 的 例子 中 , 我 们 对 一 个 元 素 都 为 1.1 的 单 精 度数 组 进行 求 和 ， 
比较 单 精度 累加 变量 和 双 精 度 累加 变量 的 计算 结果 : 


>>> b = np.ones(1986866，dtype=np.float32) * 1.1 # 创建 一 个 很 大 的 单 精度 浮 点 数 数组 
>>> b # 1.1 无 法 使 用 浮 点 数 精确 表示 ， 存 在 一 些 误差 


array([ 1.16666662， 1.16686662， . ..，1.16666682]，dtype=float32) 
>>> np.sum(b) # 使 用 单 精度 累加 变量 进行 累加 计算 ， 误 差 将 越 来 越 大 
1116926.5 


>>> np.sum(b，dtype=np.double) # 使 用 双 精 度 浮 点 数 则 能 够 得 到 正确 的 值 
1166666.6238418579 


mean0 用 于 求 数组 的 平均 值 ， 也 可 以 通过 axis 参数 指定 求 平均 值 的 轴 ， 通 过 out 参数 指定 
输出 数组 。 和 sum0 不 同 的 是 ， 对 于 整数 数组 ， 它 使 用 双 精 度 浮 点 数 进行 计算 ， 而 对 于 其 他 类 
型 的 数组 ， 则 使 用 和 数组 元 素 类 型 相同 的 累加 变量 进行 计算 : 


>>> np.mean(a,axis=1) # 整数 数组 使 用 双 精 度 浮 点 数 进 行 计算 
array([ 5.2, 3.8; 6. » 4.4]) 

>>> np.mean(b) # 单 精度 浮 点 数 使 用 单 精度 浮 点 数 进行 计算 
1.1189285 

>>> np.mean(b，dtype=np.double) # 用 双 精 度 浮 点 数 计算 平均 值 
1.1008080238418579 


除 此 之 外 ，average0 也 可 以 对 数组 进行 平均 计算 。 它 没有 out 和 dtype 参数 ,但 有 一 个 指定 
每 个 元 素 权 值 的 weights 参数 ， 请 读者 在 Python 中 输入 “np.average?” 来 查看 使 用 说 明 。 
std0 和 var0 分 别 计算 数组 的 标准 差 和 方差 ， 有 axis、onut 及 dtype 等 参数 。 


2.4.2 最 值 和 排序 


用 min0 和 max0 可 以 计算 数组 的 最 大 值 和 最 小 值 ， 而 ptp0 计 算 最 大 值 和 最 小 值 之 间 的 差 。 
它们 都 有 axis 和 out 两 个 参数 。 这 些 参数 的 用 法 和 sum0O 相 同 ， 这 里 就 不 再 多 举例 了 ， 请 读者 
自行 查看 函数 的 文档 。 

用 argmax0 和 argmin0 可 以 求 最 大 值 和 最 小 值 的 下 标 。 如 果 不 指 定 axis 参数 ， 就 返回 平坦 
化 之 后 的 数组 下 标 ， 例 如 : 


>>> np.argmax(a) # 找 到 数组 a 中 最 大 值 的 下 标 ， 有 多 个 最 值 时 得 到 第 一 个 最 值 的 下 标 
六 

>>> a.ravel()[2] # 求 平坦 化 之 后 的 数组 中 的 第 二 个 元 素 

9 


可 以 通过 unravel_index0 将 一 维 下 标 转换 为 多 维 数组 中 的 下 标 ， 它 的 第 一 个 参数 为 一 维 下 
标 值 ， 第 二 个 参数 是 多 维 数组 的 形状 : 


>>> idx = np.unravel_index(2，a.shape) 
>>> idx 

(89，2) 

>>> a[idx] 
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当 使 用 axis 参数 时 ， 可 以 沿 着 指定 的 轴 计 算 最 大 值 的 下 标 。 例 如 下 面 的 结果 表示 ， 在 数组 
a 中 ， 第 0 行 中 最 大 值 的 下 标 为 2， 第 1 行 中 最 大 值 的 下 标 为 3: 


>>> idx = np.argmax(a，axis=1) 
>>> idx 
array([2, 3, 8, 8]) 


下 面 的 语句 使 用 idx 选择 出 每 行 的 最 大 值 : 


>>> a[xrange(a.shape[6])，idx] 
array([9, 8, 9, 9]) 


数组 的 sort0 方 法 用 于 对 数组 进行 排序 ， 它 将 改变 数组 的 内 容 。 而 sort0 函 数 则 返回 一 个 新 
数组 ， 不 改变 原始 数组 。 它 们 的 axis 参数 默认 值 都 为 -1， 即 沿 着 数组 的 最 后 一 个 轴 进 行 排序 。 
sortO 函 数 的 axis 参数 可 以 设置 为 None， 此 时 它 将 得 到 平坦 化 之 后 进行 排序 的 新 数组 。 


>>> np.sort(a) # 对 每 行 的 数据 进行 排序 
array([[1, 3, 6, 7, 9], 

Ls 2205375 0] 

[@, 4, 8, 9, 9], 

[e, 1, 5, 7, 9]]) 
>>> np.sort(a，axis=8) # 对 每 列 的 数据 进行 排序 
array([[5, 1, 1, 4, 8], 

[7, 1, 3, 6, 0], 

[9 55957, 21» 

[9, 8, 9, 8, 3]]) 


argsort0 返 回 数组 的 排序 下 标 ，axis 参数 的 默认 值 为 -1: 


>>> idx = np.argsort(a) 

>>> idx 

array([[1, 4, 3, 8, 2], 
[1, 4, 2, 8, 3], 
[4, 3, 1, 0, 2], 
[4, 2, 1, 3, 89]]) 


为 了 使 用 idx 计算 排序 之 后 的 数组 ， 即 np.sort(a) 的 结果 ， 需 要 产生 第 0 轴 的 下 标 。 下 面 使 
用 ogrid 对 象 产生 第 0 轴 的 下 标 x: 


>>> x，_ = np.ogrid[:a.shape[6],:a.shape[1]] 
29 
array([[6]， 

La 

[2]， 


[3]]) 
>>> a[x, idx] # 和 np.sort(a) 的 结果 相同 
array([[1, 3, 6, 7, 9], 

Wr 2 3 Ss Bs 

| 9 9 

[8， 1，5，7，9]]) 


使 用 这 种 方法 可 以 对 两 个 相互 关联 的 数组 进行 排序 ， 即 从 数组 a 产生 排序 下 标 数组 ， 然 后 
使 用 它 对 数组 b 进行 排序 。 排 序 相关 的 函数 或 方法 还 可 以 通过 kind 参数 指定 排序 算法 , 对 于 结 
构 数组 可 以 通过 order 参数 指定 排序 所 使 用 的 字段 。 

用 median0 可 以 获得 数组 的 中 值 ， 即 对 数组 进行 排序 之 后 ， 位 于 数组 中 间 位 置 的 值 。 当 长 
度 是 偶数 时 ， 得 到 正中 间 两 个 数 的 平均 值 。 它 也 可 以 指定 axis 和 out 参数 : 


>>> np.median(a，axis=6) 
Pray(tl SA SG CS TD) 


2.4.3 多项式 函数 
多 项 式 函数 是 变量 的 整数 次 宕 与 系数 的 乘积 之 和 ， 可 以 用 下 面 的 数学 公式 表示 : 
OO)=a ta si +aaxrz +alx+ao 


由 于 多 项 式 函数 只 包含 加 法 和 乘法 运算 , 因此 它 很 容易 计算 ,并且 可 以 用 于 计算 其 他 数学 
函数 的 近似 值 。 多 项 式 函数 的 应 用 非常 广泛 ， 例 如 在 嵌入 式 系统 中 经 常会 用 它 计 算 正 弦 、 余 弦 
等 函数 。 在 NumPy 中 ,多项式 函 数 的 系数 可 以 用 一 维 数组 表示 , 例如 Jt)=x-2x+1 可 以 用 下 面 
的 数组 表示 ， 其 中 a[0] 是 最 高 次 的 系数 ，a[-1] 是 常数 项 ， 注 意 x 的 系数 为 0。 


>>> a = np.array([1.96, 89, -2, 1]) 


可 以 用 poly140 将 系数 转换 为 poly1d( 一 元 多 项 式 ) 对 象 ， 此 对 象 可 以 像 函 数 一 样 调用 ， 它 
返回 多 项 式 函数 的 值 : 


>>> p = np.polyld(a) 

>>> type(p) 

<class “numpy.1ib.polynomial.poly1ld "> 

>>> p(np.linspace(86，1，5)) 

array([ 1. ， 6.515625， 6.125 ， -0.078125,， 0. ]) 


对 polyld 对 象 进行 加 减 乘除 运算 相当 于 对 相应 的 多 项 式 函数 进行 计算 。 例 如 : 


>>> p + [-2，1] # 和 p + np.polyld([-2，1]) 相同 
polyiadL 200 0 200 2) 

>>> p * p # 两 个 3 次 多 项 式 相 乘 得 到 一 个 6 次 多 项 式 
poid([ 工 0、 =455 2 Hoy 24 lel 
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>>> p / [1，1] # 除法 返回 两 个 多 项 式 ， 分 别 为 商 式 和 余 式 
(polyld([ 1.，-1.，-1.])，polyld([ 2.])) 


于 多 项 式 的 除法 不 一 定 能 正好 整除 ， 因 此 它 返 回 除法 所 得 到 的 商 式 和 余 式 。 上 面 的 例子 
中 ， 商 式 为 x-x-1， 余 式 为 2。 因 此 将 商 式 和 被 除 式 相 乘 后 ， 再 加 上 余 式 就 等 于 原来 的 p: 


>>> p == np.polyld([ 1., -1., -1.]) * [1,1] + 2 
>>> True 


多 项 式 对 象 的 deriv0 和 integ0 方 法 分 别 计算 多 项 式 函 数 的 微分 和 积分 : 


>>> p.deriv() 
polyld([ 3., 8., -2.]) 
>>> p.integ() 
[0 
>>> p.integ().deriv() == p 
True 


多 项 式 函 数 的 根 可 以 使 用 roots0 函 数 计算 : 


>>> mr = np.roots(p) 

>>> 7 

array([-1.61863399， 1. ， 68.61863399]) 

>>> p(r) # 将 根 带 入 多 项 式 计算 ， 得 到 的 值 近似 为 8 

array([ -4.21884749e-15， -4.44689216e-16， -2.22644665e-16]) 


而 poly0 函 数 可 以 将 根 转换 回 多 项 式 的 系数 : 


>>> np.poly(r) 
array([1.689666666e+68，9.99266722e-16，-2.86866866e+88，1.698868686e+66] ) 


除了 使 用 多 项 式 对 象 之 外 ， 还 可 以 直接 使 用 NumPy 提供 的 多 项 式 函 数 对 表示 多 项 式 系数 
的 数组 进行 运算 。 可 以 在 了 Python 中 使 用 自动 补 全 查看 函数 名 : 


>>> np.poly # 按 Tab 键 

np.poly np.polyadd np.polydiv np.polyint np.polysub 
np.polyld np.polyder np.polyfit np.polymul np.polyval 
>>> np.polymul([1,1],[1,1]) 

array([1, 2, 1]) 


其 中 : polyfit0 函 数 可 以 对 一 组 数据 使 用 多 项 式 函 数 进行 拟 合 ， 找 到 和 这 组 数据 最 接近 的 
多 项 式 的 系数 。 下 面 的 程序 用 它 计 算 -x/2 ~ zx/2 区 间 与 sin(Y 函 数 最 接近 的 多 项 式 的 系数 : 


g # numpy_polyfit py 
半生 用 多 项 式 函数 拟 合 正弦 函数 


x = np.linspace(-np.pi/2，np.pi/2，16686) © 
y= np.sin(x) @ 
for deg in [3,5,7]: 
a = np.polyfit(x, y, deg) © 
error = np.abs(np.polyval(a, x)-y) @ 
print "poly %d:" % deg, a 
print "max error of order %d:" % deg , np.max(error) 


人 @ 首 先 通过 linspace0 将 -x/2 ~ x/2 区 间 等 分 为 1000 -1 等 份 ,@ 并 计算 拟 合 目标 函数 sin(x) 
的 值 。@ 将 表示 目标 函数 的 数组 传递 给 polyfit0 进 行 拟 合 ， 第 三 个 参数 deg 为 多 项 式 函数 的 最 
高 阶 数 。polyfit0 所 得 到 的 多 项 式 和 目标 函数 在 给 定 的 1000 个 点 之 间 的 误差 最 小 ，polyfit0 返 回 
多 项 式 的 系数 数组 。@ 使 用 polyval0 计 算 多 项 式 函 数 的 值 ， 并 计算 与 目标 函数 的 差 的 绝对 值 。 
由 于 正弦 函数 是 奇 函数 , 因此 只 使 用 奇数 阶 的 多 项 式 对 其 进行 拟 合 。 为 了 直观 地 观察 误差 ， 
我 们 使 用 图 2-7 显示 拟 合 之 后 的 各 阶 多 项 式 与 正弦 函数 之 间 的 误差 , 请 注意 图 中 立轴 为 对 数 坐 
标 ( 见 封 二 彩 插 )。 下 面 是 程序 的 输出 ， 可 以 看 到 由 于 正弦 函数 是 一 个 奇 函 数 ， 因 此 拟 合 的 多 项 
式 系数 中 偶 次 项 的 系数 接近 于 0。 


2-7 各 阶 多 项 式 函 数 拟 合 正弦 函数 的 误差 


poly 3: [ -1.45621694e-61 -6.39518172e-16 ”9.88749145e-61 -4.29811537e-15] 

max error of order 3: 8.66894699376768 

poly 5: [ 7.57279944e-63 -2.56656614e-17 -1.65823793e-61 -2.72346661e-18 
9.99776671e-61 7.17317591e-18] 

max error of order 5: 86.66815746861417 

poly 7: [ -1.84445514e-64 “3.76441786e-17 ”8.36942467e-63 ” -1.24633291e-16 
-1.66651593e-61 “7.46685118e-17 ”9.99997468e-61 -8.11261916e-18] 

max error of order 7: 1.52682558119e-66 
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2.4.4 ”分 段 函数 


在 2.2.3 节 中 我 们 介绍 了 如 何 使 用 frompyfunc0 函 数 计算 三 角 波形 。 由 于 三 角 波形 是 分 段 函 
数 , 需要 根据 自 变 量 的 取 值 范围 决定 计算 函数 值 的 公式 , 因此 无 法 直接 通过 ufunc 函数 计算 它 。 
NumPy 提供 了 一 些 计算 分 段 函数 的 方法 。 


g A# numpy_piecewise.py 
计生 用 where0 和 piecewise0 计 算 三 角 波形 


Python 2.6 中 新 增 了 如 下 的 判断 表达 式 语法 , 当 condition 条 件 为 True 时 , 表达 式 的 值 为 y， 
否则 为 z: 
x = Yy if condition else z 


在 NumPy 中 ，where0 函 数 可 以 看 做 判断 表达 式 的 数组 版 本 : 


x = where(condition, y, z) 


其 中 ，condition、y 和 z 都 是 数组 ， 它 的 返回 值 是 一 个 形状 与 condition 相同 的 数组 。 当 
condition 中 的 某 个 元 素 为 Tmue 时 ， 数 组 x 中 对 应 下 标的 值 从 数组 y 获取 ， 否 则 从 数组 z 获取 : 


>>> x = np.arange(16) 
>>> np.where(x<5, 9-x, x) 
array([9, 8, 7, 6, 5, 5, 6, 7, 8, 9]) 


如 果 y 和 z 是 单个 的 数值 或 者 它们 的 形状 与 condition 的 不 同 ,将 先 通过 广播 运算 使 其 形状 
一 致 : 

>>> np.where(x>6, 2*x, 8) 

array([ 68, 8, 8, 8, 0, 8, 909, 14, 16, 18]) 


使 用 whereO0 很 容易 计算 2.2.3 节 介绍 的 三 角 波 形 。 


def triangle_wave(x，c，c8，hc): 
x = x - x.astype(np.int) # 三 角 波 的 周期 为 1， 因 此 只 取 x 坐标 的 小 数 部 分 进行 计算 
return np.where(x>=c, 6, np.where(x<c@, x/c@*hc, (c-x)/(c-ce)*hc)) 


由 于 三 角 波 形 分 为 三 段 ， 因 此 需要 两 个 嵌 套 的 where0 进 行 计算 。 由 于 所 有 的 运算 和 循环 
都 在 C 语言 级 别 完成 ， 因 此 它 的 计算 效率 比 fompyfunc(O 高 。 

随 着 分 段 函数 的 分 段 数量 的 增加 ， 需 要 嵌 套 更 多 层 where0， 但 这 样 做 不 便于 程序 的 编写 
和 阅读 。 可 以 用 select0 解 决 这 个 问题 ， 它 的 调用 形式 如 下 : 


select(condlist, choicelist, default=0) 


其 中 ，condlist 是 一 个 长 度 为 N 的 布尔 数组 列表 ，choicelist 是 一 个 长 度 为 N 的 储存 候选 值 
的 数组 列表 ， 所 有 数组 的 长 度 都 为 M。 如 果 列 表 元 素 不 是 数组 而 是 单个 数值 ， 那 么 它 相当 于 元 
素 值 都 相同 且 长 度 为 M 的 数组 。 
对 于 从 0 到 M-1 的 数组 下 标 i， 从 布尔 数组 列表 中 找 出 满足 条 件 “condlistfj][] 一 True” 的 
j 的 最 小 值 ， 则 “out[ij-choicelistDj]”， 其 中 out 是 select0 的 返回 数组 。 可 以 使 用 selectO 计 算 
三 角 波形 : 
def triangle wave2(x, c¢, c9@, hc): 
x = x - x.astype(np.int) 
return np.select([x>=c, x¢c@, True], [8, x/c@*hc, (c-x)/(c-ce)*hc]) 


由 于 分 段 函 数 分 为 三 段 ， 因 此 每 个 列表 都 有 三 个 元 素 。choicelist 的 最 后 一 个 元 素 为 Tme， 
表示 前 面 所 有 条 件 都 不 满足 时 ， 将 使 用 choicelist 的 最 后 一 个 数组 中 的 值 。 也 可 以 用 default 参 
数 指定 条 件 都 不 满足 时 的 候选 值 数组 : 


return np.select([x>=c，x<c@]，[8，x/cerhc]，default=(c-x)/(c-c@)*hc) 


但 是 where0 和 select0 的 所 有 参数 都 需要 在 调用 它们 之 前 完成 计算 , 因此 NumPy 会 计算 下 
面 4 个 数组 : 


x>=c, x<c@, x/c@*hc, (c-x)/(c-ce)*hc 


在 计算 时 还 会 产生 许多 保存 中 间 结 果 的 数组 ， 因 此 如 果 输 入 的 数组 x 很 大 ， 将 会 发 生 大 量 
的 内 存 分 配 和 释放 。 
为 了 解决 这 个 问题 , NumPy 提供 了 piecewise0 专 门 用 于 计算 分 段 函 数 , 它 的 调用 参数 如 下 : 


piecewise(x, condlist, funclist) 


参数 x 是 一 个 保存 自 变量 值 的 数组 。condlist 是 一 个 长 度 为 M 的 布尔 数组 列表 ， 其 中 的 每 
个 布尔 数组 的 长 度 都 和 数组 x 相同 。funclist 是 一 个 长 度 为 M 或 M+1 的 函数 列表 ， 这 些 函 数 的 
输入 和 输出 都 是 数组 。 它 们 计算 分 段 函数 中 的 每 个 片段 。 如 果 不 是 函数 而 是 数值 ， 就 相当 于 返 
回 此 数值 的 函数 。 每 个 函数 与 condlist 中 下 标 相同 的 布尔 数组 对 应 ,如 果 funclist 的 长 度 为 M+1， 
那么 最 后 一 个 函数 对 应 于 所 有 条 件 都 为 False 时 。 下 面 是 使 用 piecewiseO 计 算 三 角 波 形 的 程序 : 


def triangle_wave3(x，c，c8，hc): 
x = x - x.astype(np.int) 
return np.piecewise(x, 
[x>=c, x<c@], 
[8@， # X>=Cc 
lambda x: x/c@*hc, # x<c@ 
lambda x: (c-x)/(c-c@)*hc]) # else 
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使 用 piecewise0 的 好 处 在 于 它 只 计算 需要 计算 的 值 。 因 此 在 上 面 的 例子 中 ， 表 达 式 
“x/c0*hec” 和 “(c-x)/(c-c0)*he” 只 对 输入 数组 x 中 满足 条 件 的 部 分 进行 计算 。 请 读者 思考 一 下 
如 何 验证 上 例 中 每 个 函数 所 计算 的 数组 的 长 度 ， 解 答 在 “numpy piecewisepy” 中 。 


2.4.5 ”统计 函数 


unique0 返 回 其 参数 数组 中 所 有 不 同 的 值 ， 并 且 按 照 从 小 到 大 的 顺序 排列 。 它 有 两 个 可 选 
参数 : 

e retum index: Ture 表示 同时 返回 原始 数组 中 的 下 标 。 

e Ietum_ inverse: True 表示 返回 重建 原始 数组 用 的 下 标 数 组 。 

下 面 通过 实例 介绍 unique0 的 用 法 。 首 先 用 randint0 创 建 含 有 10 个 元 素 、 值 在 0 到 9 范围 
之 内 的 随机 整数 数组 : 


>>> a = np.random.randint(8,5,16) 
>>> a 
array([1, 1, 9, 5, 2, 6, 7, 6, 2, 9]) 


通过 unique(a) 可 以 找到 数组 a 中 所 有 的 整数 ， 并 按照 顺序 排列 : 


>>> np.unique(a) 
array([1, 2, 5, 6, 7, 9]) 


如 果 参 数 retum_index 为 True， 就 返回 两 个 数组 ， 第 二 个 数组 是 第 一 个 数组 在 原始 数组 中 
的 下 标 : 


>>> x, idx = np.unique(a, return_index=True) 
SPP 

array([1, 2, 5, 6, 7, 9]) 

>>> idx 

array([@, 4, 3, 5, 6, 2]) 


数组 idx 保存 的 是 数组 x 中 每 个 元 素 在 数组 a 中 的 下 标 : 


>>> a[idx] 
array([1, 2, 5, 6, 7, 9]) 


如 果 参 数 retum_inverse 为 True, 那么 返回 的 第 二 个 数组 是 原始 数组 a 中 每 个 元 素 在 数组 x 
中 的 下 标 : 
>>> x, ridx = np.unique(a, return_inverse=True) 


>>> ridx 
array([9, 0, 5, 2, 1, 3, 4, 3, 1, 5]) 


>>> all(x[ridx] == a) # 原始 数组 a 和 x[ridx] 完 全 相同 


True 


bincountO 对 整数 数组 中 各 个 元 素 出 现 的 次 数 进行 统计 ， 它 要 求 数组 中 所 有 元 素 都 是 非 负 
的 。 其 返回 数组 中 第 i 个 元 素 的 值 表示 整数 i 在 参数 数组 中 出 现 的 次 数 。 


>>> np.bincount(a) 
array([0, 2, 2, 6, 0, 1, 2, 1, 0, 2]) 


由 上 面 的 结果 可 知 ， 在 数组 a 中 有 两 个 1、 两 个 2、 一 个 5、 两 个 6、 一 个 7 和 两 个 9， 而 
0、3、4、8 等 数 没 有 在 数组 a 中 出 现 。 

通过 weights 参数 可 以 指定 每 个 数 对 应 的 权 值 。 当 指定 weights 参数 时 ，bincount(x， 
weights=w) 返 回 数组 x 中 每 个 整数 所 对 应 的 w 中 的 权 值 之 和 。 用 文字 解释 比较 难以 理解 ， 下 面 
我 们 看 一 个 实例 : 


SN Panrayf[o 7 2 2 I Ol) 
>>> Ww = np.array([8.1, 8.3, 8.2, 0.4, 0.5, 0.8, 1.2]) 
>>> np.bincount(x, w) 

array([ 1.3， 1.6, 6.6]) 


上 面 的 结果 中 ，1.3 是 数组 x 中 0 所 对 应 的 w 中 的 值 (0.1 和 1.2) 的 和 ，1.6 是 1 所 对 应 的 w 
中 的 值 (0.3、0.5 和 0.8) 的 和 ， 而 0.6 是 2 所 对 应 的 w 中 的 值 (0.2 和 0.4) 的 和 。 如 果 要 求 平均 值 ， 
可 以 用 求 和 结果 与 次 数 相 除 : 


>>> np.bincount(x,w)/np.bincount(x) 
array([ 8.65 ， 0.53333333， 6.3 ]) 


histogram0) 对 一 维 数组 进行 直方 图 统计 ， 其 参数 列表 如 下 : 
histogram(a, bins=10, range=None, normed=False, weights=None) 


其 中 ，a 是 保存 待 统 计数 据 的 数组 ，bins 指定 统计 的 区 间 个 数 ， 即 对 统计 范围 的 等 分 数 。 
range 是 一 个 长 度 为 2 的 元 组 ， 表 示 统 计 范围 的 最 小 值 和 最 大 值 ， 默 认 值 为 None， 表 示范 围 由 
数据 的 范围 决定 ， 即 (amin0, amaxO)。 当 normed 参数 为 False 时 ， 函 数 返 回 数组 a 中 的 数据 在 
每 个 区 间 的 个 数 ， 否则 对 个 数 进行 正规 化 处 理 , 使 它 等 于 每 个 区 间 的 概率 密度 。weights 参数 和 
bincount0 的 类 似 。 

histogram0 返 回 两 个 一 维 数组 一 hist 和 bin_edges， 第 一 个 数组 是 每 个 区 间 的 统计 结果 ， 
第 二 个 数组 长 度 为 len(hisb+1， 每 两 个 相 邻 的 数值 构成 一 个 统计 区 间 。 下 面 我 们 看 一 个 例子 : 


>>> a = np.random.rand(166) 
>>> np.histogram(a,bins=5,range=(8,1)) 
(array([28, 26, 20, 16, 18]), array([ 6. ， 8.2, 08.4, 8.6, 8.8, 1.]) 
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首先 创建 了 一 个 包含 100 个 元 素 的 一 维 随机 数组 a， 取 值 范围 在 0 到 1 之 间 。 然 后 用 
histogram0 对 数组 a 中 的 数据 进行 直方 图 统计 。 结 果 显 示 有 20 个 元 素 的 值 在 0 到 0.2 之 间 ，26 
个 元 素 的 值 在 0.2 到 0.4 之 间 。 读者 可 以 尝试 用 rand0 创 建 更 大 的 随机 数组 ， 由 统计 结果 可 知 每 
个 区 间 出 现 的 次 数 近似 相等 ， 因 此 rand0 所 创建 的 随机 数 在 0 到 1 范围 之 间 是 平均 分 布 的 。 

如 果 需 要 统计 的 区 间 长 度 不 等 ， 可 以 将 表示 区 间 分 隔 位 置 的 数组 传递 给 bins 参数 ， 例 如 : 


>>> np.histogram(a，bins=[6，6.4，6.8，1.9]，range=(6,1)) 
(array([46, 36, 18]), array([ 6. ， 8.4, 86.8，1. ])) 


结果 表示 : 0 到 0.4 之 间 有 46 个 值 ，0.4 到 0.8 之 间 有 36 个 值 。 
如 果 用 weights 参数 指定 了 数组 a 中 每 个 元 素 对 应 的 权 值 ， 那 么 histogram0 将 对 区 间 中 数 
值 对 应 的 权 值 进 行 求 和 。 下 面 看 一 个 使 用 histogram0 统 计 男 青少年 年 龄 和 身高 的 例子 。 


办 height.csv 


100 名 年 龄 在 7 到 20 岁 之 间 的 男性 青少年 的 身高 统计 数据 


首先 用 loadtxt0 从 数据 文件 载 入 数据 ， 关 于 文件 存 取 方面 的 内 容 后 面 还 会 详细 介绍 : 


>>> d = np.loadtxt("height.csv", delimiter=",") 
>>> d.shape 
(100, 2) 


在 数组 d 中 ， 第 0 列 是 年 龄 ， 第 1 列 是 身高 。 可 以 看 到 年 龄 的 范围 在 7 到 20 之 间 : 


>>> np.min(d[:,6]) 
7 了 .8999999999999996 
>>> np.max(d[:,9]) 
19.899999999999999 


下 面 对 数 据 进行 统计 ，sums 是 每 个 年 龄 段 的 身高 总 和 ，cnts 是 每 个 年 龄 段 的 数据 个 数 ， 
此 很 容易 计算 出 每 个 年 龄 段 的 平均 身高 : 


>>> sums = np.histogram(d[:,6],bins=range(7,21),range=(7,26)，weights=d[:,1])[6] 

>>> cnts = np.histogram(d[:,6],bins=range(7,21),range=(7,26))[8] 

>>> sums/cnts 

array([ 125.96 ， 132.66666667， 137.82857143， 143.8 
148.14 ， 153.44 ， 162.15555556, 166.86666667， 
172.83636364， 173.3 Pe 75 ， 174.19166667， 175.675 ]) 


日 


histogram2d0 和 histogramdd0 用 来 对 二 维和 N 维 数据 进行 直方 图 统计 ， 我 们 将 在 第 12 章 
对 histogram2d0 进 行 详细 介绍 。 


2S 线性 代数 


NumPy 和 MATLAB 不 同 ， 对 于 多 维 数组 的 运算 ， 默 认 情况 下 并 不 使 用 矩阵 运算 。 如 果 读 
者 希望 对 数组 进行 矩阵 运算 ， 可 以 调用 相应 的 函数 。 


matrix 对 象 

NumpPy 库 提 供 了 matrix 类 ， 使 用 matrix 类 创建 的 是 矩阵 对 象 ， 它 们 的 加 减 乘除 运算 默 
认 采 用 矩阵 方式 计算 , 因此 用 法 和 MATLAB 十 分 类 似 。 但 是 由 于 Numpy 中 同时 存在 ndarray 
和 matrix 对 象 ， 因 此 用 户 很 容易 将 两 者 弄 混 。 这 有 违 Python 的 “ 显 式 优 于 隐 式 ”的 原则 ， 
因此 并 不 推荐 在 较 复杂 的 程序 中 使 用 matrix 对 象 。 下 面 是 使 用 matrix 的 一 个 例子 : 


>>> a = np.matrix([[1,2,3],[5,5,6],[7,9,9]]) 

>>> ara**-1 

matrix([[ 1.606006600e+060, 1.66533454e-16, -8.32667268e-17]， 
[ -2.77555756e-16, 1.66666666e+68， -2.77555756e-17]， 
[ 1.66533454e-16, 5.55111512e-17, ”1.66666666e+66]]) 


因为 a 是 用 matrix0 创 建 的 矩阵 对 象 ， 因 此 乘法 和 稼 运算 符 都 变 成 了 矩阵 运算 ， 于 是 上 
面 计算 的 是 矩阵 a 与 其 逆 矩 阵 的 乘积 ， 结 果 是 一 个 单位 矩阵 。 


2.5.1 各 种 乘积 运算 


矩阵 的 乘积 可 以 使 用 dot0 来 计算 。 对 于 二 维 数组 ， 它 计算 的 是 矩阵 乘积 ， 对 于 一 维 数组 ， 
它 计算 的 是 内 积 。 当 需要 将 一 维 数组 当 作 列 矢量 或 行 矢量 进行 矩阵 运算 时 , 推荐 先 使 用 reshape0 
将 一 维 数组 转换 为 二 维 数组 : 


>>> a = array([1, 2, 3]) 
>>> a.reshape((-1,1)) 
array([[1], 

[2]， 

[3]]) 
>>> a.reshape((1,-1)) 


array([[1, 2, 3]]) 


除了 使 用 dot0 计 算 乘积 之 外 ，NumpPy 还 提供 了 inner0 和 outer0 等 多 种 计算 乘积 的 函数 。 

这 些 函 数 计算 乘积 的 方式 不 同 ， 尤 其 是 当 参数 是 多 维 数组 时 ， 很 容易 搞 混 淆 。 
edot: 对 于 两 个 一 维 数组 ， 计 算 的 是 这 两 个 数组 对 应 下 标 元 素 的 乘积 和 ， 数 学 上 称 之 
为 内 积 。 对 于 二 维 数组 ， 计 算 的 是 两 个 数组 的 矩阵 乘积 ， 对 于 多 维 数组 ， 它 的 通用 
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计算 公式 如 下 。 即 结果 数组 中 的 每 个 元 素 都 是 : 数组 a 最 后 一 维 上 的 所 有 元 素 与 数组 
b 倒数 第 二 维 上 的 所 有 元 素 的 乘积 和 。 


dot(a, b)[i,j,k,m] = sum(a[i,j,:] * b[k,:,m]) 


下 面 以 两 个 3 维 数组 的 乘积 演示 dot 乘积 的 计算 结果 。 首 先 创建 两 个 3 维 数组 ， 这 两 个 数 
组 的 最 后 两 维 满足 矩阵 乘积 的 条 件 : 


>>> a = np.arange(12) .reshape(2,3,2) 
>>> b = np.arange(12,24) .reshape(2,2,3) 
>>> c = np.dot(a,b) 


dot 乘积 的 结果 c 是 数组 a 和 的 多 个 子 矩 阵 的 乘积 : 


>>> np.alltrue( c[@,:,8,:] == np.dot(a[6],b[86]) ) 
True 
>>> np.alltrue( c[1,:,8,:] == np.dot(a[1],b[86]) ) 
True 
>>> np.alltrue( c[8,:,1,:] == np.dot(a[6],b[1]) ) 
True 
>>> np.alltrue( c[1,:,1,:] == np.dot(a[1],b[1]) ) 
True 


。 inner: 和 dot 乘积 一 样 ， 对 于 两 个 一 维 数组 ， 计 算 的 是 这 两 个 数组 对 应 下 标 元 素 的 乘 
积 和 。 对 于 多 维 数组 ， 它 计算 的 结果 数组 中 的 每 个 元 素 都 是 : 数组 a 和 b 最 后 一 维 的 
内 积 ， 因 此 数组 a 和 b 最 后 一 维 的 长 度 必须 相同 。 


inner(a, b)[i,j,k,m] = sum(a[i,j,:]*b[k,m,:]) 
下 面 是 inner 乘积 的 演示 : 


>>> a = np.arange(12) .reshape(2,3,2) 

>>> b = np.arange(12,24) .reshape(2,3,2) 
>>> c = np.inner(a,b) 

>>> c.shape 

(2 

>>> c[8,8,8,8] == np.inner(a[86,86],b[6,6]) 
True 

>>> c[6,1,1,6] == np.inner(a[8,1],b[1,6]) 
True 

>>> c[1,2,1,2] == np.inner(a[1,2],b[1,2]) 
True 


。 outer: 只 按照 一 维 数组 进行 计算 ， 如 果 传 入 参数 是 多 维 数组 ， 先 将 此 数组 展 平 为 一 
维 数组 ， 然 后 再 进行 运算 。outer 乘积 计算 列 向 量 和 行 向 量 的 矩阵 乘积 : 


>>> np.outer([1,2,3],[4,5,6,7]) 
array([[ 4, 5, 6, 7], 
D0. 2 A]; 
2 5 LT) 


2.5.2 ” 解 线性 方程 组 


对 和 矩阵 的 一 些 更 高 级 运算 可 以 在 NumPy 的 线性 代数 模块 linalg 中 找到 。 例 如 inv0 计 算 逆 
矩阵，solve0 可 以 求解 多 元 一 次 方程 组 。 下 面 是 solve0 的 一 个 例子 : 


>>> a = np.random.rand(16,16) 

>>> b = np.random.rand(16) 

>>> x = np.linalg.solve(a,b) 

>>> np.sum(np.abs(np.dot(a,x) - b)) 
3.1433189384699745e-15 


solve0 有 两 个 参数 a 和 b。a 是 一 个 N*N 的 二 维 数组 ， 而 是 一 个 长 度 为 N 的 一 维 数组 ， 
solve0 找 到 一 个 长 度 为 N 的 一 维 数组 x， 使 得 它们 满足 a*x = bp， 即 x 就 是 这 个 N 元 一 次 方程 
组 的 解 。 

lstsq0 比 solve0 更 一 般 化 ， 它 不 要 求 矩 阵 a 是 正方 形 的 ， 也 就 是 说 方程 的 个 数 可 以 少 于 、 
等 于 或 多 于 未 知 数 的 个 数 。 它 找到 一 组 解 x， 使 得 | - a*x| 最 小 。 我 们 称 得 到 的 结果 为 最 小 二 
乘 解 , 即 它 使 得 所 有 等 式 的 误差 的 平方 和 最 小 。 下 面 以 求解 离散 卷 积 的 逆 运 算 为 例 , 介绍 lstsq0 
的 用 法 。 

首先 简单 介绍 一 下 离散 卷 积 的 相关 知识 和 计算 方法 。 对 于 一 个 离散 的 线性 时 不 变 系统 h， 
如 果 它 的 输入 是 x， 那 么 其 输出 y 可 以 用 x 和 刀 》 的 卷 积 表示 : 

y=x 轨 


离散 卷 积 的 计算 公式 如 下 : 
yn] = > hm]xln —m] 


假设 的 长 度 为 N, x 的 长 度 为 M， 则 卷 积 计算 得 到 的 y 的 长 度 将 为 N+M-1。 它 的 每 个 值 
都 是 按照 下 面 的 公式 计算 得 到 的 : 


y[8] = h[e]*x[e] 

y[1] = h[e]*x[1] + h[1]*x[e] 

y[2] = h[e]*x[2] + h[1]*x[1] + h[2]*x[e] 
y[3] = h[e]*x[3] + h[1]*x[2] + h[2]*x[1] 
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y[N+M-1] = h[N-1]*x[M-1] 


所 谓 卷 积 的 逆 运 算 ， 是 指 : 假设 已 知 x 和 y， 需 要 求解 n。 由 于 的 长 度 为 N， 于 是 有 NN 
个 未 知 数 , 而 由 于 y 的 长 度 为 N+M - 1， 因此 这 NN 个 未 知 数 需要 满足 N+M - 1 个 线性 方程 。 由 
于 方程 数 比 未 知 数 多 ， 卷 积 的 逆 运 算 不 一 定 有 精确 解 ， 因 此 问题 就 变 成 了 找到 一 组 h， 使 得 它 
和 x 的 卷 积 与 y 之 间 的 误差 最 小 ， 显 然 它 就 是 最 小 二 乘 解 。 下 面 的 程序 演示 了 如 何 使 用 lstsq0 
计算 卷 积 的 逆 运 算 。 


本 numpy_lstsq.py 
读 ”用 最 小 二 乘法 求 卷 积 的 逆 运 算 


import numpy as np 
from numpy.l1ib.stride tricks import as_strided 


def make_data(M, N, noise scale): © 
x = np.random.standard_normal(M) 
h = np.random.standard_normal(N) 
y = np.convolve(x, h) 
yn = y+ np.random.standard normal(len(y)) * noise scale * np.max(y) 
return x, yn, h 


def solve h(x, y, N): © 
X = as_strided(x, shape=(len(x)-N+1, N), strides=(x.itemsize, x.itemsize)) © 
Y = y[N-1:len(x)] @ 
h = np.linalg.1stsq(X，Y) © 
return h[6][::-1] @ 


@ 首 先 make data0 创 建 需要 的 数据 ， 它 使 用 standard_normal0 计 算 正规 分 布 的 随机 数 数组 
作为 x、y。 它 返回 系统 的 输入 信号 x， 以 及 添加 了 随机 噪声 的 输出 信号 yn。 为 了 和 最 小 二 乘法 
的 结果 比较 ， 我 们 同时 也 输出 了 系统 的 系数 h。 

@solve_h0 使 用 最 小 二 乘法 计算 系统 的 参数 h， 因 为 通常 我 们 不 知道 未 知 系统 的 系数 的 长 
度 ， 因 此 这 里 用 N 表示 所 求 系数 的 长 度 。 

观察 前 面 的 卷 积 方程 组 可 知 ， 在 N+M - 1 个 方程 中 ， 中 间 的 M - N+1 个 方程 使 用 了 的 
所 有 系数 。 为 了 程序 计算 方便 ,我 们 对 这 M - N+1 个 方程 进行 最 小 二 乘 运算 。@ 因 此 根据 的 
长 度 ， 需 要 将 一 维 数组 x 变换 成 一 个 形状 为 (M - N+1, N) 的 二 维 数组 X， 它 的 每 行 相对 于 上 一 
行 都 左 移 了 一 个 元 素 。 这 个 二 维 数组 可 以 很 容易 地 使 用 前 面 介绍 过 的 as_strided0 得 到 。@ 我 们 
取出 输出 数组 y 中 与 数组 XX 每 行 对 应 的 部 分 ，@ 然 后 调用 Istsq0 对 这 M - N+1 个 方程 进行 最 小 
二 乘 运算 。@lstsq0 返 回 一 个 元 组 ， 它 的 第 0 个 元 素 是 最 小 二 乘 解 ， 注 意 所 得 到 的 结果 顺序 是 
颠倒 的 ， 因 此 我 们 还 需要 对 其 进行 翻转 。 


x, yn, h = make_data(1666，168，6.4) 


H = solve_h(x，yn，126) 
H2 = solve_h(x，yn，86) 


接 下 来 对 长 度 为 100 的 未 知 系统 系数 h， 分 别 使 用 长 度 为 80 和 120 的 两 个 系数 对 其 求 最 
小 二 乘 解 。 图 2-8 是 程序 运行 得 到 的 结果 ， 虚 线 是 未 知 系统 的 系数 ， 实 线 是 最 小 二 乘法 的 解 。 
由 于 对 系统 的 输出 添加 了 一 些 噪声 信号 ， 因 此 二 者 并 不 完全 吻合 。 


图 2-8 使 用 最 小 二 乘法 求解 卷 积 逆 运 算 : 解 的 长 度 分 别 为 120( 上 ) 和 80( 下 ) 


2.6 撞 码 数组 


在 很 多 情况 下 , 数据 可 能 是 不 完整 的 或 者 存在 无 效 数值 。 例 如 对 图 像 数组 中 某 个 不 规则 形 
状 区 域 中 的 数据 进行 处 理 ， 或 者 从 传感器 中 获取 的 数据 存在 无 效 值 。 在 NumPy 中 可 以 使 用 掩 
码 数组 表示 这 样 的 数据 , numpy.ma 模块 中 提供 了 处 理 掩 码 数 组 的 各 种 函数 。 这 些 函数 几乎 完 
整地 复制 了 NumPy 提供 的 所 有 函数 ， 为 它们 增加 处 理 掩 码 数组 的 功能 。 读 者 可 以 使 用 IPython 
的 自动 完成 功能 查看 它们 。 

一 个 掩 码 数组 由 一 个 正常 数组 和 一 个 布尔 数组 组 成 。 布 尔 数 组 中 值 为 True 的 元 素 表示 正 
常数 组 中 对 应 下 标的 值 无 效 ，False 表示 有 效 。 下 面 看 一 个 例子 。 首 先 载 入 ma 模块 ， 并 创建 一 
个 随机 数组 x 和 一 个 布尔 数组 mask。 然 后 调用 ma.aray0 用 这 两 个 数组 组 成 一 个 掩 码 数组 : 
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>>> import numpy.ma as ma 

>>> x = np.array([1,2,3,5,7,4,3,2,8,9]) 

>>> mask = x < 5 # 小 于 5 的 值 无 效 

>>> mx = ma.array(x，mask=mask) # 创建 掩 码 数组 

>>> mx 

masked_array(data = [-- -- -- 57 -- -- -- 8 --], 
mask = [ True True True False False True True True False True]， 
fil1l_value = 999999) 


为 了 计算 掩 码 数值 中 有 效 数组 的 平均 值 ， 可 以 调用 它 的 mean( 方 法 ， 或 者 调用 ma 模块 中 
的 mean0 函 数 : 


>>> mx.mean() # 计算 掩 码 数组 中 有 效 数值 的 平均 值 
6.666666666666667 

>>> ma.mean(mx) 

6.666666666666667 


为 了 验证 上 面 的 结果 ， 下 面 用 “~” 操 作 符 对 mask 数组 取 反 ， 并 用 它 作 为 下 标 获取 数组 x 
中 的 有 效 数值 ， 然 后 调用 np.meanO 计 算 平均 值 : 


>>> np.mean(x[~mask]) # 使 用 ~mask 作为 下 标 获取 有 效 数 值 的 数组 ， 并 求 平均 值 。 
6.666666666666667 


实际 上 ，np.mean0 由 于 直接 调用 数组 对 象 的 mean0 方 法 ， 因 此 用 np.mean0 也 可 以 求 掩 码 
数组 的 平均 值 : 


>>> np.mean(mx) 
6.666666666666667 


NumPy 中 的 有 些 函 数 不 能 正确 处 理 掩 码 数组 ， 为 了 不 引起 混淆 ， 建 议 读者 在 对 掩 码 数组 
进行 处 理 时 ， 都 使 用 ma 模块 中 定义 的 函数 。 例 如 : 


>>> np.cov(mx) 
array(6.9333333333333336) 
>>> ma.cov(mx) 
masked_array(data = 2.33333333333， 
mask = False, 
fill_value = le+20) 


通过 掩 码 数组 的 data 属性 可 以 获得 其 数值 数组 ，mask 属性 可 以 获得 掩 码 用 的 布尔 数组 。 
filled0 方 法 返回 使 用 包 L value 属性 表示 的 填充 值 蔡 代 无 效 值 之 后 的 数组 。 下 面 将 填充 值 修改 为 
- 1， 然 后 获得 填充 之 后 的 数组 : 


>>> mx.fill value = -1 


>>> mx.filled() 
SPrayg[= = < 5 To = 1 8 -LU]) 


和 一 般 数 组 一 样 ， 掩 码 数 组 也 可 以 使 用 各 种 下 标 对 象 对 其 进行 存 取 ， 例 如 : 


>>> mx[6] 

masked 

>>> mx[:4] 

masked_array( 
data = [-- -- -- 5], 
mask = [ True True True False], 
fill value = 999999) 

>>> mx[6] = 3 # 填 入 有 效 值 

>>> mx[8] 

EF) 

>>> mx[3] = ma.masked # 用 masked 设置 为 无 效 值 


除了 直接 指定 布尔 数组 之 外 ， 还 可 以 通过 ma 模块 提供 的 各 种 创建 掩 码 数组 的 函数 ， 将 数 
组 中 满足 指定 条 件 的 元 素 全 部 设置 为 无 效 。 这 些 函数 全 部 以 “masked ”开头 , 可 以 通过 IPython 
的 自动 完成 功能 进行 查看 。 


>>> ma.masked_ # 按 Tab 键 进行 自动 完成 


ma.masked_all ma.masked_inside ma.masked_outside 
ma.masked all_ like ma.masked_invalid ma.masked_print_option 
ma.masked_array ma.masked_less ma.masked_singleton 
ma.masked_equal ma.masked_less_equal ma.masked_values 
ma.masked_greater ma.masked_not_equal ma.masked_where 


ma.masked_greater_equal ma.masked object 


通过 函数 名 可 以 很 容易 猜 出 它们 的 功能 ， 这 里 就 不 一 一 详细 叙述 了 ， 下 面 我 们 看 一 个 具体 
的 例子 。 

下 面 的 程序 先 创建 一 个 形状 为 (3,10000)、 值 为 正 态 分 布 的 数组 x。 然 后 调用 masked_outside() 
创建 一 个 掩 码 数组 ， 将 其 中 小 于 0 或 大 于 1 的 值 设 置 为 无 效 ， 然 后 计算 掩 码 数 组 第 1 轴 上 各 个 
数值 的 方差: 


>>> x = np.random.normal(size=(3,16666)) 
>>> mx = ma.masked_outside(x, 8, 1) 
>>> mx.var(axis=1) 
masked_array(data = [ 6.67932837 8.68613628 6.68656745]， 
mask = False, 
fill_ value = 1le+26) 


而 原始 数组 的 方差 为 : 
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>>> x.var(axis=1) 
array([ 1.63962568， 6.99996538， 1.86297267]) 


2.7 文件 存 取 


NumpPy 提供 了 多 种 存 取 数 组 内 容 的 文件 操作 函数 。 保 存 数 组 数据 的 文件 可 以 是 二 进 制 格 
式 或 文本 格式 。 二 进 制 格式 的 文件 又 分 为 NumPy 专用 的 格式 化 二 进 制 类 型 和 无 格式 类 型 。 

使 用 数组 对 象 的 tofile0 方 法 可 以 方便 地 将 数组 中 的 数据 以 二 进 制 格 式 写 进 文件 。tofile0 输 
出 的 数据 不 保存 数组 形状 和 元 素 类 型 等 信息 。 因 此 用 fromfile0 函 数 读 回 数据 时 需要 用 户 指定 元 
素 类 型 ， 并 对 数组 的 形状 进行 适当 的 修改 : 


>>> a = np.arange(9,12) 
>>> a.shape = 3,4 
>>> a 
array([[ 8, 1, 2, 3], 
[as 5, 6 7], 
Lg 9 10, 111]) 
>>> a.tofile("a.bin") 
>>> b = np.fromfile("a.bin"，dtype=np.float) # 按照 float 类 型 读 入 数据 
>>> b # 读 入 的 数据 是 错误 的 
array([ 2.12199579e-314, 6.36598737e-314, 1.66699796e-313， 
1.48539765e-313， 1.98979621e-313, 2.33419537e-313]) 
>>> a.dtype # 查看 a 的 dtype 
dtype('int32') 
>>> b = np.fromfile("a.bin"，dtype=np.int32) # 按照 int32 类 型 读 入 数据 
>>> b # 数据 是 一 维 的 
mPay(tl BO 1 2 3 My 5 B73 8, 19329394]) 
>>> b.shape = 3，4 # 按照 数组 a 的 shape 修改 数组 b 的 shape 
>>> b # 这 次 终于 正确 了 
array[E ed 2> 3 
[S56 7 
55 95 


从 上 面 的 例子 可 以 看 出 ， 在 读 入 数据 时 需要 正确 设置 dtype 参数 ， 并 修改 数组 的 shape 属 
性 才能 得 到 和 原始 数据 一 致 的 结果 。 无 论 数据 的 排列 顺序 是 C 语言 格式 还 是 Fortran 语言 格式 ， 
tofile0 都 统一 使 用 C 语言 格式 输出 。 此 外 如 果 指 定 了 sep 参数 ，fromfile0 和 tofile0 将 以 文本 格 
式 对 数组 进行 输入 输出 。sep 参数 指定 的 是 文本 数据 中 数值 的 分 隔 符 。 

load0 和 save0 用 NumPy 专用 的 二 进 制 格式 保存 数据 ， 它 们 会 自动 处 理 元 素 类 型 和 形状 等 
祝 息 : 


>>> np.save("a.npy", a) 
>>> c = np.load( "a.npy”) 
>>> C 
arraylE GE 3 27 3]5 
[ 4，5，6，7]， 
9 0 441) 


如 果 想 将 多 个 数组 保存 到 一 个 文件 中 ， 可 以 使 用 savez0。savez0 的 第 一 个 参数 是 文件 名 ， 
其 后 的 参数 都 是 需要 保存 的 数组 ， 也 可 以 使 用 关键 字 参 数 为 数组 起 名 ， 非 关键 字 参 数 传递 的 数 
组 会 自动 起 名 为 ar _ 0、arr_ 1、.…。savez0 输 出 的 是 一 个 扩展 名 为 npz 的 压缩 文件 ， 其 中 每 个 文 
件 都 是 一 个 用 save0 保 存 的 npy 文件 ， 文 件 名 和 数组 名 相同 。load0 自 动 识 别 npz 文件 ， 并 且 返 
回 一 个 类 似 于 字典 的 对 象 ， 可 以 通过 以 数组 名 作为 键 来 获取 数组 的 内 容 : 


>>> a = np.array([[1,2,3],[4,5,6]]) 

>>> b = np.arange(6，1.96，6.1) 

>>> Cc = np.sin(b) 

>>> np.savez("result.npz", a, b, sin array = c) 

>>> rr = np.load("result.npz") 

>>> r["arr_e"] # 数组 a 

array([[1, 2, 3], 
[4, 5, 6]]) 

>>> r["arr_1"] # 数组 b 

array([ 8. ， 9.1, 8.2, 0.3, 0.4, 0.5, 0.6,，08.7，09.8，08.9]) 

>>> r["sin_array"] # 数组 c 

array([ 6. ， 6.69983342， 8.19866933， 8.29552621， 8.38941834， 
0@.47942554, 6.56464247， 8.64421769， 8.71735669， 9.78332691]) 


用 解压 软件 打开 “result.npz” 文 件 ， 会 发 现 其 中 有 三 个 文件 :“arr_0.npy”、“arr_l.npy” 
和 “sin_array.npy”， 其 中 分 别 保存 着 数组 a、b、c 的 内 容 。 


个 save0 和 savez0 输 出 的 二 进 制 文件 有 特殊 的 格式 ， 较 难 用 其 他 语言 编写 的 程序 读 入 。 


savetxt0 和 loadtxtO 可 以 读 写 保存 一 维和 二 维 数组 的 文本 文件 。 例 如 可 以 用 它们 读 写 CSV 
格式 的 文本 文件 : 


>>> a = np.arange(0,12,0.5).reshape(4,-1) 
>>> np.savetxt("a.txt"，a) # 默认 按照 '%.18e' 格 式 保存 数值 ， 以 空格 分 隔 
>>> np.loadtxt("a.txt") 
seray(ll Gs “O52 de Dy ‘20320 

| -rE 
GBD 
-|1 | 
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>>> np.savetxt("a.txt"，a，fmt="%d"，delimiter=",") # 改 成 保存 为 整数 ， 以 逗号 分 隔 
>>> np.loadtxt("a.txt",delimiter=",") # 读 入 的 时 候 也 需要 指定 逗号 分 隔 
et | Re st I 0 

| i SS CE Ee 

DG Gs 7 7 8 Bl 

D9 9 0 30 Tl 1 


有 的 CSV 文件 中 除了 保存 数值 之 外 ， 还 保存 一 些 说 明文 字 ， 例 如 第 一 行 和 第 一 列 通 常 为 
列 名 和 行 名 。 如 果 需 要 忽略 CSV 文件 的 第 一 行 和 第 一 列 ， 可 以 先 将 文件 读 为 字符 串 数 组 ， 然 
后 取出 需要 的 部 分 ， 转 换 为 数值 数组 。 例 如 对 于 下 面 的 CSV 数据 文件 : 


姓名 ,年 龄 ,体重 ,身高 
张 三 ,38,75,165 
李 四 ,45,68,178 
王 五 ,15,38,120 


可 以 采用 如 下 程序 读 入 其 中 的 数值 部 分 : 


5 A# numpy_read_csv.py 
总 读 取 CSV 文 件 


>>> tmp = np.loadtxt("test.csv", dtype=np.str, delimiter=",") 
>>> data = tmp[1:,1:].astype(np.float) 
>>> data 
apray([ll 30.5 7555 165.]; 
L 60 2760]; 
| i 


此 外 , 使 用 结构 数组 也 能 读 入 这 样 的 文件 , 并 且 可 以 使 用 不 同 的 元 素 类 型 保存 每 个 列 的 值 ， 
下 面 先 定义 结构 数组 的 类 型 : 


>>> persontype = np.dtype({ 
'names':['name', "age"， 'weight', 'height'], 
Formmts 1 S02 


由 于 文件 中 的 第 一 行 不 是 数据 ， 因 此 需要 先 打开 数据 文件 ， 读 取 了 第 一 行 之 后 ， 再 把 文件 
对 象 传递 给 loadtxt0: 


>>> f = file("test.csv") 

>>> f.readline() 

>>> data = np.loadtxt(f, delimiter=",", dtype=persontype) 
>>> print data 

[('\xe5\xbc\xa@\xe4\xb8\x89', 36, 75.0, 165.06) 


('\xe6\x9d\x8e\xe5\x9b\x9b', 45, 60.0, 178.0) 
('\xe7\x8e\x8b\xe4\xba\x94', 15, 36.06, 128.0)] 


实际 上 ， 前面 介绍 的 所 有 读 写 文件 的 函数 都 可 以 直接 使 用 已 经 打开 的 文件 对 象 。 如 果 使 用 
文件 对 象 ， 可 以 将 多 个 数组 存储 到 一 个 npy 文件 中 : 


>>> a = np.arange(8) 

>>> b = np.add.accumulate(a) 
>>>c=a+b 

>>> f = file("result.npy", "wb") 

>>> np.save(f，a) # 顺序 将 数组 a、b、c 保存 到 文件 对 象 中 
>>> np.save(f，b) 

>>> np.save(f，c) 

>>> 下 .close() 

>>> f = file("result.npy"，"rb") 

>>> np.load(f) # 顺序 从 文件 对 象 f 中 读 取 内 容 
arnay([6 1, 2, 3, 4, 5, 6, 7]) 

>>> np.load(f) 

array([ 6, 1, 3, 6, 190, 15, 21, 28]) 
>>> np.load(f) 

array([ 8, 2, 5, 9 14, 28, 27, 35]) 


2.8 ”内 存 映射 数组 


当 需 要 存 取 一 个 很 大 的 数据 文件 中 的 一 小 部 分 数据 时 , 将 整个 文件 读 入 内 存 进行 操作 显然 
很 费 资源 的 。 使 用 内 存 映 射 数组 (memory-mapped-file array) 能 够 帮助 我 们 快速 解决 问题 。 


个 在 32 位 操作 系统 中 ， 程 序 使 用 的 有 内 存 映 射 数组 的 空间 总 和 小 于 2GB。 


内 存 映射 数组 使 用 memmap0 创 建 ， 它 的 调用 参数 如 下 : 
memmap(filename, dtype=uint8, mode="r+", offset=8, shape=None, order="C") 


。 filename: 存储 数组 的 文件 名 ， 除 了 "w+" 模 式 之 外 ， 文 件 必须 存在 ， 并 且 已 经 存储 有 
数据 。 

e dtype: NumPy 的 数据 类 型 ， 可 以 是 内 置 的 数据 类 型 ， 也 可 以 是 用 户 自己 定义 的 结构 
类 型 。 

e offset: 文件 中 存储 数据 的 起 始 位 置 ， 以 字 节 为 单位 。 
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。 mode: 文件 操作 模式 ,，"r" 表 示 只 读 ，"c" 表 示 可 以 修改 数组 但 不 写 入 文件 ，"r+" 表 示 可 
对 数组 进行 读 写 ， 并 自动 将 结果 保存 回 文件 ，"w+" 表 示 创 建文 件 或 覆盖 已 有 的 文件 。 
。 order: 元 素 排列 格式 ，"C" 表 示 C 语言 格式 ，"F" 表 示 Fortran 语言 格式 。 
下 面 通过 一 个 实例 说 明 内 存 映射 数组 的 用 法 。 首 先 使 用 "w+" 模 式 创建 一 个 内 存 映 射 数组 ， 
运行 完 下 面 的 语句 之 后 ， 将 会 生成 一 个 名 为 “tmp.dat” 的 文件 ， 内 容 是 10 个 值 为 0 的 字 节 。 


>>> a = np.memmap("tmp.dat", mode="w+", shape=(2,5)) 
>>> a 
memmap([[8, 8, 8, 8, 8], 

[e@, 8, 8, 8, 8]], dtype=uint8) 
>>> file("tmp.dat").read() 
"“\X66\x68\x68\x68\x68\x68\x68\x68\x88\x66 


接 下 来 将 数组 a 中 每 个 元 素 都 改 为 字符 a 的 ASCI 码 ， 然 后 调用 flush0 方 法 将 所 有 改动 写 
入 文件 中 : 


>>> a[:] = ord("a") 

>>> a.flush() 

>>> file("tmp.dat").read() 
"aaaaaaaaaa 


这 时 “tmp dat” 文件 的 内 容 变 成 了 10 个 字符 8。 然后 用 "c" 模 式 打开 此 文件 ， 修 改 其 中 的 
一 些 元 素 为 字符 b， 虽 然 内 存 中 的 数据 已 经 修改 ， 但 是 即使 调用 flush0， 也 不 会 将 结果 写 入 文 
件 中 : 


>>> b = np.memmap("tmp.dat", mode="c", shape=(2,5)) 
>>> b 
memmap([[97, 97, 97, 97, 97], 
[97, 97, 97, 97, 97]], dtype=uint8) 
>>> b[1] = ord("b") 
>>> b 
memmap([[97，97，97，97，97]， 
[98，98，98，98，98]]，dtype=uint8) 
>>> b.flush() 
>>> file("tmp.dat").read() 
"aaaaaaaaaa 


“tmp.dat” 文 件 的 内 容 仍然 是 10 个 'a'。 如 果 使 用 "t+" 模式 ， 就 会 将 改动 写 入 文件 中 : 


>>> Cc = np.memmap("tmp.dat", shape=(2,5)) 
>>> c[1] = ord("c") 

>>> c.flush() 

>>> file("tmp.dat").read() 


“aaaaaCCCCC 


此 时 再 看 看 数组 a 和 b 中 的 值 ， 数 组 a 的 值 改变 了 ， 而 数组 b 没有 改变 : 


>>> a 
memmap([[97, 97, 97, 97, 97], 
[99, 99, 99, 99, 99]], dtype=uint8) 
>>> b 
memmap([[97，97，97，97，97]， 
[98，98，98，98，98]]，dtype=uint8) 


许多 格式 的 文件 (例如 WAV 和 BMP) 都 有 一 个 文件 头 ， 然 后 才 是 数据 内 容 。 为 了 正确 读 取 
数据 , 需要 使 用 offset 参数 指定 数据 的 偏 移 量 , 下 面 的 例子 演示 了 如 何 使 用 memmap 读 写 BMP 
文件 。 读者 可 以 使 用 Windows 自 带 的 画笔 软件 手工 创建 一 张 1000*1000 的 24 bit 的 bmp 文件 ， 
也 可 通过 运行 本 书 提 供 的 程序 来 创建 。 


7 create_ bmp.py 


创建 一 个 大 小 为 1000*1000 的 24 bit 的 BMP 文件 


这 里 我 们 不 关心 文件 头 中 有 些 什么 内 容 ， 只 想 知道 BMP 文件 头 的 大 小 。 查 看 创建 的 BMP 
文件 的 大 小 , 为 3 000 054 个 字 节 ,显然 BMP 文件 头 的 大 小 为 54 个 字 节 ， 其 后 是 1000*1000*3 
个 字 节 ， 用 来 表示 图 像 中 每 个 像素 的 颜色 。 

然后 使 用 下 面 的 程序 为 图 像 中 的 每 个 像素 赋值 : 


4 A numpy_change bmp.py 
使 用 memmap 数组 修改 BMP 文件 中 像素 点 的 颜色 


import numpy as np 


# shape = 高 ， 宽 ， 颜 色 
bmp = np.memmap("tmp.bmp"，offset=54，shape=(1666,1666,3)) © 


# 产生 一 组 从 8 到 255 的 渐变 值 
tmp = np.linspace(6，255，1666) .astype(np.uint8) © 


# 水 平 蓝 色 渐变 

bmp[:, :, 0] = tmp © 

# 垂直 绿色 渐变 

bmp[:，:，1] = tmp.reshape(-1,1) © 
# 红色 成 分 

bmp[:，:，2] = 127 © 


bmp.flush() © 
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@ 调 用 np .memmap(0) 来 创建 内 存 映射 数组 。offset 参数 指定 了 文件 中 数据 的 偏 移 量 ， 而 
shape 参数 指定 了 数据 的 形状 。BMP 文件 的 高 度 和 宽度 均 为 1000 个 像素 ， 每 个 像素 点 为 3 个 
uint8 的 整数 , 因此 得 到 的 数组 bmp 是 一 个 三 维 数组 , 其 形状 为 (1000,1000,3)。 第 0 轴 表示 BMP 
图 像 的 高 ， 第 1 轴 表 示 宽 ， 第 2 轴 表 示 每 个 像素 点 的 蓝 绿 红 三 种 颜色 的 分 量 。 

@ 使 用 linspace0 产 生 一 组 从 0 到 255 渐变 的 uint8 数组 ，@ 并 将 其 分 别 赋值 给 bmp 数组 的 
蓝 色 和 绿色 部 分 ，@ 红 色 部 分 我 们 全 部 设置 为 127。@ 最 后 调用 flush0, 确保 内 存 中 的 数据 能 
写 回 BMP 文件 中 。 这 样 就 得 到 了 一 张 彩色 的 渐变 图 像 。 


SciPy 一 一 数值 计算 库 


Scipy 在 NumpPy 的 基础 上 增加 了 众多 的 数学 、 科 学 以 及 工程 计算 中 常用 的 模块 , 例如 线性 
代数 、 常 微分 方程 数值 求解 、 信 号 处 理 、 图 像 处 理 、 稀 朴 矩 阵 ， 等 等 。 在 本 章 ， 将 通过 实例 介 
绍 SciPy 中 常用 的 一 些 模块 。 为 了 方便 读者 理解 ， 在 实例 程序 中 会 使 用 matplotlib 和 Mayavi 给 
制 二 维和 三 维 图 表 ， 在 阅读 实例 源 程序 时 ， 读 者 可 以 忽略 绘图 部 分 ， 在 后 续 章节 中 ， 我 们 会 对 
这 些 绘图 库 进 行 详细 介绍 。 


3.1 常数 和 特殊 函数 


SciPy 的 constants 模块 包含 了 众多 的 物理 常数 : 


>>> from scipy import constants as C 
>>> C.c # 真空 中 的 光速 

299792458.6 

>>> C.h # 普 朗 克 常 数 
6.62666936666686662e-34 


在 字典 physical constants 中 ， 以 物理 常量 名 为 键 ， 对 应 的 值 是 一 个 含有 三 个 元 素 的 元 组 ， 
分 别 为 常数 值 、 单 位 及 误差 ， 例 如 下 面 的 程序 可 以 查看 电子 质量 : 


>>> C.physical_constants["electron mass"] 
(9.1693825999999998e-31，“kg' ，1.5999999999999999e-37) 


除了 物理 常数 之 外 ，constants 模块 中 还 包括 许多 单位 信息 ， 例 如 : 


>>> C.mile # 1 英里 等 于 多 少 米 
1689.3439999999998 

>>> C.inch # 1 英寸 等 于 多 少 米 
昌 .925399999999999999 

>>> C.gram # 1 克 等 于 多 少 千克 
8.601 

>>> C.pound # 1 磅 等 于 多 少 千克 
8@.45359236999999997 


贡 业 于 应 内 一 /dpS 
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SciPy 的 special 模块 是 一 个 非常 完整 的 函数 库 ， 其 中 包含 了 基本 数学 函数 、 特 殊 数学 函数 
以 及 NumPy 中 出 现 的 所 有 函数 。 由 于 函数 数量 众多 ， 本 节 仅 对 其 进行 简要 介绍 。 至 于 具体 包 
含 的 函数 列表 ， 请 读者 参考 SciPy 的 帮助 文档 。 

伽 玛 函数 工 是 概率 统计 学 中 经 常 出 现 的 一 个 特殊 函数 ， 它 的 计算 公式 如 下 : 


T(z) = 人 ee 


显然 ， 通 过 此 公式 计算 工 函数 的 值 是 比较 麻烦 的 ， 我 们 可 以 用 special 模块 中 的 gamma0 
进行 计算 : 

>>> import scipy.special as S 

>>> S.gamma(4) 

6.9 

>>> S.gamma(6.5) 

1.7724538589855159 

>>> S.gamma(1+1j) # gamma 函数 支持 复数 

(8.49861566811835629-6.15494982836181166]j) 

>>> S.gamma(1666) 

inf 


T 函数 是 阶乘 函数 在 实数 和 复数 范围 上 的 扩展 ， 它 的 增长 速度 非常 快 ， 因 为 1000 的 阶乘 
已 经 超过 了 双 精 度 浮 点 数 的 表示 范围 ， 因 此 结果 是 无 穷 大 。 为 了 计算 更 大 的 范围 ， 可 以 使 用 
gammaln0: 


>>> gammaln(1966) 
5985 .2264232691817 


gammaln(x) 计 算 In(|T(x) |) 的 值 ， 它 使 用 特殊 的 算法 ， 直 接 计 算 工 函数 的 对 数值 ， 因 此 可 
以 表示 更 大 的 范围 。 

special 模块 中 的 某 些 函 数 并 不 是 数学 意义 上 的 特殊 函数 ， 例 如 1loglp(x) 计 算 log(1+x) 的 值 。 
这 是 由 于 浮 点 数 的 精度 有 限 , 无 法 很 精确 地 表示 十 分 接近 1 的 实数 。 例如 无 法 用 浮 点 数 表示 “1 
+ le-20” 的 值 ， 因 此 “log(1+le-20)” 的 值 为 0， 而 当 使 用 loglp0 时 ， 则 可 以 很 精确 地 计算 : 


>>> 1 + le-26 

1.9 

>>> S5.1og(1+le-26) 
8.6 

>>> S5.1oglp(le-26) 
9.9999999999999995e-21 


实际 上 当 x 非常 小 时 ，loglpG9) 约 等 于 x， 这 可 以 通过 对 log(1+x) 进 行 泰勒 级 数 展开 加 以 证 
明 。 在 下 一 章 我 们 会 学 习 如 何 用 符号 计算 库 SymPy 进行 泰勒 级 数 展开 。 


3.2 ”优化 一 一 optimize 


SciPy 的 optimize 模块 提供 了 许多 数值 优化 算法 ， 本 节 对 其 中 的 数据 拟 合 、 函 数 最 小 值 以 
及 解 非 线性 方程 组 等 进行 简单 的 介绍 。 


3.2.1 最 小 二 乘 拟 合 


假设 有 一 组 实验 数据 (i, y)， 我 们 事先 知道 它们 之 间 应 该 满足 某 函 数 关 系 y=ftxj)， 通 过 这 
些 已 知 信息 ， 需 要 确定 函数 的 一 些 参数 。 例 如 ， 如 果 函 数 了 是 线性 函数 jty)=kr+b， 那 么 参数 
和 5b 就 是 需要 确定 的 值 。 

如 果 用 p 表示 函数 中 需要 确定 的 参数 ， 那 么 目标 就 是 找到 一 组 p， 使 得 下 面 的 函数 5 的 值 
最 小 : 


M 
S(p)= > [一 Ac pp 
i=l 


这 种 算法 被 称 为 最 小 二 乘 拟 合 (Least-square fitting)。 在 optimize 模块 中 ， 可 以 使 用 leastsq0 
对 数据 进行 最 小 二 乘 拟 合计 算 。leastsq0 的 用 法 很 简单 ， 只 需要 将 计算 误差 的 函数 和 待 确定 参数 
的 初始 值 传递 给 它 即 可 。 下 面 是 用 leastsq0 对 线性 函数 进行 拟 合 的 程序 。 


a scipy_least_square line.py 
用 最 小 二 乘法 拟 合 直线 ， 并 显示 误差 曲面 


import numpy as np 
from scipy.optimize import leastsq 


X= np.array([ 8.19, 2.72, 6.39, 8.71, 4.7 ，2.66，3.78]) 
Y = np.array([ 7.01, 2.78, 6.47, 6.71, 4.1 ， 4.23, 4.65]) 


def residuals(p): © 
"计算 以 p 为 参数 的 直线 和 原始 数据 之 间 的 误差 " 
k，b = p 
return Y - (k*X + b) 


# leastsq 使 得 residuals() 的 输出 数组 的 平方 和 最 小 ， 参 数 的 初始 值 为 [1,6] 
r= leastsq(residuals，[1，6]) @ 

k, b = r[e] 

print “k =",k, "b =",b 


程序 的 输出 为 : 


k = 8.613495346194 b = 1.79469255555 


向 粮 斗 启 问 一 Ad!2S 
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图 3-1( 左 ) 直 观 地 显示 了 原始 数据 、 拟 合 直线 以 及 它们 之 间 的 误差 。@residuals0 的 参数 p 是 
拟 合 直线 的 参数 ， 函 数 返回 的 是 原始 数据 和 拟 合 直线 之 间 的 误差 。 图 中 用 数据 点 到 拟 合 直线 在 
立轴 上 的 距离 表示 误差 。@leastsq0 使 得 这 些 误差 的 平方 和 最 小 , 即 图 中 所 有 正方 形 的 面积 之 和 
最 小 。 
由 前 面 的 函数 $ 的 公式 可 知 ， 对 于 直线 拟 合 来 说 ， 误 差 的 平方 和 是 直线 参数 上 和 好 的 二 次 
多 项 式 函 数 ， 因 此 可 以 用 图 3-1( 右 ) 所 示 的 曲面 直观 地 显示 误差 平方 和 与 两 个 参数 之 间 的 关系 。 
图 中 用 灰色 圆 球 表 示 曲 面 的 最 小 点 ， 它 的 X-Y 轴 的 坐标 就 是 leastsq0 的 拟 合 结果 。 下 面 的 函数 
S0 用 来 计算 误差 曲面 ， 其 参数 k 和 均 为 二 维 数组 : 


def S(k, b): 
"计算 直线 y=k*x+b 和 原始 数据 X、Y 的 误差 的 平方 和 " 
error = np.zeros(k.shape) 
or x, yy In zip(X, Y): 
error += (y - (kKk*x + b))**2 


return error 


四 


3-1 最 小 二 乘法 拟 合 的 直线 以 及 误差 ( 左 )， 误 差 和 两 个 参数 k、b 之 间 的 关系 ( 右 ) 


接 下 来 ， 让 我 们 再 看 一 个 对 正弦 波 数据 进行 拟 合 的 例子 : 


a scipy_least_square_sin.py 
使 用 最 小 二 乘法 对 带 噪声 的 正弦 波 数据 进行 拟 合 


def func(x，p): © 


数据 拟 合 所 用 的 函数 : A*sin(2*pi*k*x + theta) 


A, k, theta=p 
return A*np.sin(2*np.pi*k*x+theta) 


def residuals(p, y, x): © 


实验 数据 x、y 和 拟 合 函 数 之 间 的 差 ，p 为 拟 合 需 要 找到 的 系数 


return y - func(x, p) 
x = np.linspace(6，2*#np.pi，166) 
A，k，theta = 16，6.34，np.pi/6 # 真实 数据 的 函数 参数 
ye = func(x，[A，k，theta]) # 真实 数据 
# 加 入 噪声 之 后 的 实验 数据 
yl = ye + 2 * np.random.randn(len(x)) © 
pe = [7，6.2，9] # 第 一 次 猜测 的 函数 拟 合 参数 


# 调用 leastsq 进行 数据 拟 合 

# residuals 为 计算 误差 的 函数 

# pe 为 拟 合 参数 的 初始 值 

# args 为 需要 拟 合 的 实验 数据 

plsq = leastsq(residuals, pe, args=(y1, x)) @ 
print u" 真 实 参数 :"，[A，k，theta] 

print u" 拟 合 参数 "，plsq[8] # 实验 数据 拟 合 后 的 参数 


程序 中 ，@ 要 拟 合 的 目标 函数 func0 是 一 个 正弦 函数 ， 它 的 参数 p 是 一 个 数组 ， 包 含 决定 
正弦 波 的 三 个 参数 :A、k、theta， 分 别 对 应 正弦 函数 的 振幅 、 频 率 和 相 角 。®@@ 待 拟 合 的 实验 数据 
是 一 组 包含 噪声 的 数据 : (x,y1)， 其 中 数组 yl 在 标准 正弦 波 数据 y0 之 上 添加 了 随机 噪声 。 

@ 用 leastsq0 对 带 噪声 的 实验 数据 (x, yl) 进 行 数据 拟 合 ， 它 可 以 找到 数组 x 和 真实 数据 y0 
之 间 的 正弦 关系 ， 即 确定 A、k、theta 等 参数 。 和 前 面 的 直线 拟 合 程序 不 同 的 是 ， 这 里 我 们 将 
(y1, x) 传 递 给 args 参数 。leastsq0 会 将 这 两 个 额外 的 参数 传递 给 residuals0。@ 因 此 residuals0 有 
三 个 参数 ，p 是 正弦 函数 的 参数 ，y 和 x 是 表示 实验 数据 的 数组 。 下 面 是 程序 的 输出 : 


真实 参数 : [19，68.34666668686686662，8.52359877559829882] 
拟 合 参数 : [-9.84152775 ”6.33829767 -2.68899335] 


我 们 看 到 : 拟 合 结果 中 振幅 和 频率 基本 一 致 ， 但 相 角 却 完全 不 同 。 由 于 正弦 函数 具有 周期 
性 ， 这 两 个 相 角 实际 上 相差 整数 个 周期 。 如 图 3-2 所 示 ， 拟 合 的 结果 和 实际 的 数据 是 一 致 的 ( 见 
封 二 彩 插 )。 

如 果 频 率 的 初 值 和 真实 值 差别 很 大 ， 拟 合 结果 中 的 频率 参数 可 能 不 能 收敛 于 实际 的 频率 。 
这 时 可 以 通过 其 他 方法 先 估算 一 个 频率 的 近似 值 。 
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图 3-2 使 用 最 小 二 乘法 对 带 噪声 的 正弦 波 数据 进行 拟 合 


3.2.2 ”函数 最 小 值 


optimize 模块 还 提供 了 许多 求 函数 最 小 值 的 算法 : fmin、fmin powell、 fimin_cg、 fimin bfes 
等 。 下 面 我 们 用 一 个 实例 观察 这 些 “fmin*0” 是 如 何 找到 函数 的 最 小 值 的 。 在 本 例 中 ， 要 计算 
最 小 值 的 函数 fx,y) 为 : 
fx,y) = -0 +100(y —x)’ 


为 了 提高 运算 速度 和 精度 ， 有 些 “fmin*0” 带 有 一 个 fprime 参数 ， 它 是 计算 目标 函数 1 对 
各 个 自 变量 的 偏 导数 的 函数 。jfsy 对 变量 x 和 ? 的 偏 导 函 数 为 : 


人 < —2+2x—400x(y—x’),—— = 200y —200x? 
3 ea 


这 个 函数 叫做 Rosenbrock 函数 ， 它 经 常用 来 测试 最 小 化 算法 的 收敛 速度 。 它 有 一 个 十 分 
平坦 的 山谷 区 域 ， 收 敛 到 此 山谷 区 域 比 较 容易 ， 但 是 在 山谷 区 域 搜索 到 最 小 点 则 比较 困难 。 根 
据 函 数 的 计算 公式 不 难看 出 此 函数 的 最 小 值 是 0， 在 (1,1) 处 。 

下 面 的 程序 计算 f(x, y) 的 最 小 值 ， 并 且 绘 制 出 f(x, 9 所 表示 的 曲面 和 寻找 最 小 值 时 的 搜索 
路 径 。 


5 scipy_fmin demo.py 
半 于 观察 fmin* 函 数 计算 最 小 值 时 的 路 径 


import scipy.optimize as opt 
import numpy as np 
import sys 


points = [] 


def f(p): © 
XD 
Z = (1-x)**2 + 100*(y-x**2)**2 
points.append((x,y,z)) 
return Z 


def fprime(p): © 
x,y=p 
dx = -2 + 2*x - 400*x*(y - x**2) 
dy = 260*y - 200*Xx**2 
return np.array([dx, dy]) 


init_point =(-2,-2) © 


try: 

method = sys.argv[1] 
except: 

method = "fmin bfgs” 


fmin func = opt._dict_ [method] @ 
if method in ["fmin", "fmin powell"]: 
result = fmin func(f, init point) # 参 数 为 目标 函数 和 初始 值 
elif method in ["fmin_cg", "fmin bfgs", "fmin 1 bfgs_b", "fmin tnc"]: 
result = fmin func(f, init point, fprime) # 参 数 为 目标 函数 、 初 始 值 和 导 函 数 
elif method in ["fmin_cobyla"]: 
result = fmin func(f, init point, []) 
else: 
print "fmin function not found” 
Sys .exit(6) 


提 ## 绘图 部 分 

import pylab as pl 

p= np.array(points) 

xmin, xmax = np.min(p[:,8])-1, np.max(p[:,8])+1 
ymin, ymax = np.min(p[:,1])-1, np.max(p[:,1])+1 
Y, X = np.ogrid[ymin:ymax:566j,xmin:xmax:566j] 
Z = np.1og16(f((X，Y))) 

zmin，zmax = np.min(Z)，np.max(Z) 

pl.imshow(Z, extent=(xmin,xmax,ymin,ymax), origin="bottom", aspect="auto") 
pl.plot(p[:,8], p[:,1]) 

pl.scatter(p[:,8], p[:,1],c=range(len(p))) 
pl.xlim(xmin,xmax) 

pl.ylim(ymin,ymax) 

pl.show() 


基业 玫 应 内 一 人 ds 


85 


机 商 玫 应 啥 一 dos 


86 


Python 科学 计算 


@fO 计 算 ftc,y) 的 函数 值 ， 为 了 记录 下 最 小 化 过 程 中 的 计算 轨迹 ， 在 们 中 将 每 个 计算 过 的 
点 都 添加 进 全 局 列表 points 中 。@fprimeO 计 算 fix,y) 对 两 个 自 变 量 在 p 处 的 偏 导 函数 的 值 。 

罩 最 小 化 的 初 值 设置 为 (-2.2)，@@ 此 程序 从 optimize 模块 的 ”dict 字典 中 获得 由 命令 行 
参数 指定 的 最 小 值 函 数 。 不 同 的 “fmin*0” 参 数 有 所 不 同 ， 例 如 有 些 算法 不 需要 fprime0。 

最 后 将 曲面 和 计算 点 的 路 径 绘制 成 图 ， 效 果 如 图 3-3 所 示 ( 见 封 二 彩 插 )。 它 显示 了 fmin0 
和 fmin_bfgs0 搜 索 最 小 值 时 的 轨迹 。 可 以 看 出 : 由 于 fmin_ bfgs0 使 用 了 偏 导 函 数 fprime0， 
此 它 能 够 更 快 地 找到 最 小 值 。 这 里 使 用 图 像 表 示 二 维 函 数 的 值 ， 值 越 大 则 颜色 越 红 ， 值 越 小 则 
颜色 越 蓝 。 为 了 更 清晰 地 显示 函数 的 山谷 区 域 ， 图 中 显示 的 实际 上 是 通过 对 数 函数 log100 对 
Ji 中 进行 处 理 之 后 的 结果 。 
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图 3-3 finin 最 小 化 时 的 计算 轨迹 ( 左 )，finin_bfes 最 小 化 时 的 计算 轨迹 ( 右 ) 


3.2.3“” 非 线性 方程 组 求解 
optimize 模块 中 的 fsolve0 可 以 对 非 线 性 方程 组 进行 求解 ， 它 的 基本 调用 形式 如 下 : 
fsolve(func, x@) 


func 是 计算 方程 组 误差 的 函数 ， 它 的 参数 x 是 一 个 数组 ， 其 值 为 方程 组 的 一 组 可 能 的 解 。 
func 返回 将 x 代入 方程 组 之 后 得 到 的 每 个 方程 的 误差 , x0 为 未 知 数 的 一 组 初始 值 。 假 设 要 对 下 
面 的 方程 组 进行 求解: 
fllulu2u3)=0, Plulu2,u3)=0, flul,u2,u3)=0 
那么 func 可 以 如 下 定义 : 


def func(x): 
ul1,u2,u3 = x 
return [f1i(u1,u2,u3), f2(u1,u2,u3), f3(u1,u2,u3)] 


下 面 我 们 看 一 个 对 下 列 方程 组 求解 的 例子 。 


Sx1+3=0, 4 x0-2sin(x1 x2)=0, x1 x2-1.5=0 


ww scipy_fsolve.py 
使 用 fsolve 求 非 线性 方程 组 的 解 


from scipy.optimize import fsolve 
from math import sin 
def f(x): © 
x80, x1, x2 = x.tolist() © 
return [ 
5*X1+3， 
4*x@*x@ - 2*sin(x1*x2), 
x1*x2 - 1.5 
] 
# 下 计算 方程 组 的 误差 ，[1,1,1] 是 未 知 数 的 初始 值 
result = fsolve(f, [1,1,1]) © 
print result 
print f(result) 


程序 的 输出 为 : 


[-8.78622857 -8.6 =255 ] 
[8.6，-9.1266332624187868e-14，5.3296765182667514e-15] 


@fO 是 计算 方程 组 误差 的 函数 ，x 参数 是 一 组 可 能 的 解 。fsolve0 在 调用 f0 时 ， 传 递 给 f0 
的 参数 是 一 个 数组 。@ 先 调用 数组 的 tolist0 方 法 ， 将 其 转换 为 Python 的 标准 浮 点 数列 表 ， 然 后 
调用 math 模块 中 的 函数 进行 运算 。 因 为 在 进行 单个 数值 的 运算 时 ， 标 准 浮 点 类 型 比 NumPy 的 
浮 点 类 型 要 快 许多 , 所 以 把 数值 都 转换 成 标准 浮 点 数 类 型 ,能 缩短 一 些 计算 时 间 。@ 调 用 folve0 
时 ， 传 递 计算 误差 的 函数 们 以 及 未 知 数 的 初始 值 。 

在 对 方程 组 进行 求解 时 ,fsolve0 会 自动 计算 方程 组 在 某 点 对 各 个 未 知 数 变 量 的 偏 导数 ， 这 
些 偏 导数 组 成 一 个 二 维 数 组 ， 数 学 上 称 之 为 雅 可 比 矩阵 。 如 果 方 程 组 中 的 未 知 数 很 多 ， 而 与 每 
个 方程 有 关联 的 未 知 数 较 少 ， 即 雅 可 比 矩 阵 比较 稀疏 时 ， 将 计算 雅 可 比 矩 阵 的 函数 作为 参数 传 
递 给 fiolve0， 将 能 大 幅度 提高 运算 速度 。 笔 者 在 一 个 模拟 计算 的 程序 中 需要 求解 有 50 个 未 知 
数 的 非 线 性 方程 组 ,每 个 方程 平均 与 6 个 未 知 数 相关 ,通过 传递 计算 雅 可 比 和 矩阵 的 函数 使 fsolveO0 
的 计算 速度 提高 了 4 倍 。 


雅 可 比 矩 阵 
雅 可 比 和 矩阵 是 一 阶 偏 导数 以 一 定 方式 排列 的 矩阵 ， 它 给 出 了 可 微分 方程 与 给 定点 的 最 
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优 线性 逼近 ， 因 此 类 似 于 多 元 函数 的 导数 。 例 如 前 面 的 函数 五 、 包 、 和 名 和 未 知 数 1、u2、 
3 的 雅 可 比 和 矩阵 如 下 : 


aA 


Oul Ou26u3 
S222 


Oul Ou26u3 
HII33 


Oul Ou20u3 


使 用 雅 可 比 矩阵 的 求解 程序 如 下 : 


A# scipy_fsolve_jacobian.py 
全 一 使 用 雅 可 比 行列 式 求 非 线性 方程 组 的 解 


def j(x): © 
x90, x1, x2 = x.tolist() 
return [ 
[8，5，9]， 
[8*x@, -2*x2*cos(x1*x2), -2*x1*cos(x1*x2)], 
[@, x2, x1] 
] 


result = fsolve(f, [1,1,1], fprime=j) @ 


@ 计 算 雅 可 比 和 矩阵 的 函数 j0 和 人 0 一 样 ， 其 x 参数 是 未 知 数 的 一 组 值 , 它 计 算 非 线性 方程 
组 在 x 处 的 雅 可 比 和 矩阵 。@ 通 过 fprime 参数 将 j0 传 递 给 folve0。 由 于 本 例 中 的 未 知 数 很 少 ， 
因此 计算 雅 可 比 矩 阵 并 不 能 显著 地 提高 计算 速度 。 


3.3 ”插值 一 interpolate 


插值 是 一 种 通过 已 知 的 离散 数据 来 求 未 知 数据 的 方法 。 与 拟 合 不 同 的 是 ， 它 要 求 曲线 通过 
所 有 的 已 知 数据 。SciPy 的 interpolate 模块 提供 了 许多 对 数据 进行 插值 运算 的 函数 。 


3.3.1 B 样 条 曲线 插值 


一 维 数据 的 插值 运算 可 以 通过 interp1d0 完 成 。 其 调用 形式 如 下 , 它 实际 上 不 是 函数 而 是 一 
个 类 : 


interpld(x, y, kind="'linear'’, ...) 


其 中 : 参数 x 和 y 是 一 系列 已 知 的 数据 点 ; 参数 kind 是 插值 类 型 ， 可 以 是 字符 串 或 整数 。 


参数 kind 给 出 了 插值 的 B 样 条 曲线 的 阶 数 ， 可 以 有 如 下 候选 值 : 

e 'zero'、mearest: 阶梯 插值 ， 相 当 于 0 阶 B 样 条 曲线 。 

e'slinear、'inear': 线性 插值 , 用 一 条 直线 连接 所 有 的 取样 点 ,相当 于 1 阶 B 样 条 曲线 ， 
slinear 使 用 扩展 库 中 的 相关 函数 进行 计算 , 而 linear 则 直接 使 用 Python 编写 的 函数 进 
行 运算 ， 它 们 的 结果 一 样 。 

e quadratic、'cubic: 2 阶 和 3 阶 B 样 条 曲线 ,更 高 阶 的 曲线 可 以 直接 使 用 整数 值 指定 。 

e interpld 对 象 可 以 计算 x 的 取 值 范围 之 内 任意 点 的 函数 值 。 它 可 以 像 函 数 一 样 直接 调 
用 ， 像 Numpy 的 ufunc 函数 一 样 能 对 数组 中 的 每 个 元 素 进行 计算 ， 并 返回 一 个 新 的 
数组 。 

下 面 的 程序 演示 了 参数 kind 与 其 对 应 的 插值 曲线 ， 其 结果 如 图 3-4 所 示 ( 见 封 二 彩 插 )。 


FE scipy interpld.py 
读 使 用 interp140 对 数据 进行 各 阶 插值 


import numpy as np 
from scipy import interpolate 
import pylab as pl 


x = np.linspace(6，16，11) 
y = np.sin(x) 


xnew = np.linspace(6，16，161) 

pl.plot(x,y,'ro') 

for kind in ['nearest', 'zero', 'slinear', 'quadratic']: 
f = interpolate.interp1ld(x,y,kind=kind) © 
ynew = f(xnew) © 
pl.plot(xnew, ynew, label=str(kind)) 


pl.legend(loc="lower right') 
pl.show() 


图 3-4 使 用 参数 kind 指定 插值 曲线 的 阶 数 
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程序 中 我 们 使 用 循环 对 相同 的 数据 进行 4 种 不 同 阶 数 的 插值 运算 。@ 首 先 使 用 数据 点 创建 
一 个 interpld 对 象 f， 通过 kind 参数 指定 其 阶 数 。@ 调 用 们 计算 出 一 系列 的 插值 结果 。 本 例 中 ， 
决定 插值 曲线 的 数据 点 一 共有 11 个 ， 插 值 之 后 的 曲线 数据 点 有 101 个 。 


3.3.2 ”外 推 和 Spline 拟 合 


前 面 介绍 的 interp1d 类 要 求 其 参数 x 是 一 个 递增 序列 ， 并 且 只 能 在 x 的 取 值 范围 之 内 进行 
内 插 计算 ， 不 能 用 它 进行 外 推 运算 ， 即 无 法 计算 x 的 取 值 范围 之 外 的 数据 点 。UnivariateSpline 
类 的 插值 运算 比 interp1d 更 高 级 ， 它 支持 外 推 运算 ， 其 调用 形式 如 下 : 


UnivariateSpline(x, y, w=None, bbox=[None, None], k=3, s=None) 


x、y 是 保存 数据 点 的 X-Y 坐标 的 数组 ， 其 中 x 必须 是 递增 序列 。 
w 是 为 每 个 数据 点 指定 的 权重 值 。 

k 为 样 条 曲线 的 阶 数 。 

s 是 平滑 参数 ， 它 使 得 最 终生 成 的 样 条 曲线 满足 条 件 2(w-(y 一 spline(x)))” < s ， 即 当 
s>0 时 ， 样 条 曲线 并 不 一 定 通过 各 个 数据 点 。 为 了 让 曲线 通过 所 有 数据 点 ， 必 须 将 s 参 
数 设置 为 0。 

下 面 的 程序 演示 了 如 何 使 用 UnivariateSpline 对 数据 进行 插值 、 外 推 及 样 条 曲线 拟 合 : 


sh scipy_uspline.py 
使 用 UnivariateSpline 进行 插值 运算 


xl = np.linspace(86，16，26) 

y1 = np.sin(x1) 

sx1 = np.linspace(96，12，166) 

sy1 = interpolate.UnivariateSpline(x1，y1，s=6)(sSxl) © 
x2 = np.linspace(86，26，266) 

y2 = np.sin(x2) + np.random.standard_normal(len(x2))*6.2 
sx2 = np.linspace(9，26，2666) 

sy2 = interpolate.UnivariateSpline(x2，y2，s=8)(sx2) © 


@ 如 图 3-5( 上 ) 所 示 ，UnivariateSpline 能 够 进行 外 推 运算 ， 虽 然 输入 数据 中 没有 X 轴 大 于 
10 的 点 ， 但 是 它 能 计算 出 X 轴 在 0 到 12 的 插值 结果 ( 见 封 二 彩 插 )。 在 X 轴 大 于 10 的 部 分 ， 
样 条 曲线 仍然 呈现 出 和 正弦 波 类 似 的 形状 ， 越 远离 输入 数据 范围 ， 误 差 会 越 大 ， 因 此 外 推 的 范 
围 是 有 限 的 。 由 于 s 参数 为 0， 因此 插值 曲线 经 过 所 有 的 数据 点 。 

@ 图 3-5( 下 ) 则 显示 了 s 参数 不 为 零 时 的 结果 ， 对 于 带 噪声 的 输入 数据 ， 选 择 合适 的 s 参 
数 能 够 使 得 样 条 曲线 接近 无 噪声 时 的 波形 ， 可 以 把 它 看 作 使 用 样 条 曲线 对 数据 进行 拟 合 运算 
( 见 封 二 彩 插 )。 


图 3-5 使 用 UnivariateSpline 进行 插值 : 外 推 (上 )， 数 据 拟 合 (下 ) 


3.3.3 ”二 维 插值 
使 用 interp2d0 可 以 进行 二 维 插值 运算 ， 它 的 调用 形式 如 下 : 
interp2d(x，y，z，kind='linear"，...) 


其 中 : x、y、z 都 是 一 维 数组 ， 如 果 传 入 的 是 多 维 数 组 ， 就 先 将 它 转换 为 一 维 数组 ，kind 
参数 指定 插值 运算 的 阶 数 ， 可 以 为 linear、'cubic' 或 quintic 。 

下 面 的 例子 对 某 个 函数 曲面 上 的 网 格 点 进行 二 维 插值 ， 效 果 如 图 3-6 所 示 ( 见 封 二 彩 插 )。 
其 中 ， 左 图 显示 插值 之 前 的 数据 ， 右 图 显示 插值 运算 后 得 到 的 结果 。 


图 3-6 使 用 interp2d 进行 二 维 插值 


更 scipy_interp2d.py 
使 用 interp2d 函数 进行 二 维 插值 


def func(x, y): © 
return (x+y)*np.exp(-5.0*(x**2 + y**2)) 
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# X-Y 轴 分 为 15*15 的 网 格 

y，x = np.mgrid[-1:1:15j, -1:1:15j] @ 

fvals = func(x,y) # 计算 每 个 网 格 点 上 的 函数 值 

# 二 维 插值 

newfunc = interpolate.interp2d(x，y，fvals，kind='cubic ') © 
# 计算 166*166 的 网 格 上 的 插值 

xnew = np.linspace(-1,1,166) 

ynew = np.linspace(-1,1,166) 

fnew = newfunc(xnew，ynew) @ 


@finc 是 计算 曲面 上 各 点 高 度 的 函数 。@@ 计 算 X、Y 轴 在 -1 到 1 范围 之 内 ， 大 小 为 15*15 
的 等 间距 网 格 上 各 点 的 高 度 。 注 意 所 得 到 的 二 维 数组 fvals 的 第 0 轴 与 Y 轴 对 应 ， 第 一 轴 与 和 
轴 对 应 。 息 使 用 网 格 上 各 点 的 X、Y 和 ZZ 轴 的 坐标 创建 mterp2d 对 象 ， 这 里 我 们 使 用 二 阶 插值 
曲面 。@interp2d 对 象 可 以 像 函数 一 样 调用 ， 我 们 用 它 计算 插 值 曲面 在 一 个 更 密 的 网 格 中 的 高 
度 值 。 注 意 这 里 的 参数 是 两 个 一 维 数组 ， 分 别 指定 网 格 的 X-Y 轴 坐 标 ， 而 不 需要 通过 mgrid 创 
建 网 格 坐标 数组 。 

interp2d 只 能 对 网 格 形状 的 取样 值 进行 插值 运算 , 如 果 需 要 对 随机 散 列 的 取样 点 进行 插值 ， 
就 需要 使 用 径 向 基 函 数 (Radial Basis Function， 简 称 RBF) 插 值 算法 。RBF 支持 多 维 散 列 点 的 插 
值 运算 ， 下 面 以 二 维 插值 为 例 演 示 RBF 的 使 用 方法 。 


Scipy_Ibfpy 
这 使 用 RBF 对 随机 取样 点 进行 二 维 插值 


def func(x,y): 
return (x+y)*np.exp(-5.0*(x**2 + y**2)) 
# 计算 曲面 函数 上 16 个 随机 分 布 的 点 
x = np.random.uniform(-1.6，1.6，size=166) 
y = np.random.uniform(-1.6，1.6，size=166) 
fvals = func(x,y) © 
# 使 用 RBF 进行 插值 运算 
newfunc = interpolate.Rbf(x，y，fvals，function='multiquadric') @ 
ynew，xnew = np.mgrid[-1:1:166j，-1:1:166j] # 插值 结果 的 网 格 
fnew = newfunc(xnew，ynew) © 
truevals = func(xnew，ynew) # 函数 的 真实 值 


@ 随 机 计算 曲面 上 的 100 个 点 ，@ 使 用 随机 点 创建 一 个 RBF 对 象 ， 并 通过 function 参数 指 
定 所 使 用 的 径 向 基 函 数 。 读 者 可 以 查看 帮助 文档 以 了 解 更 多 的 径 向 基 函 数 选 项 。@RBF 对 象 也 
可 以 像 函 数 那样 被 调用 , 我 们 用 它 计 算 更 密 的 网 格 上 各 点 的 值 。 它 的 两 个 参数 是 指定 X-Y 轴 坐 


标的 两 个 数组 。 和 interp2d 对 象 不 同 的 是 ， 它 不 会 自动 产生 网 格 上 的 各 点 ， 因 此 为 了 使 用 等 距 
的 正 交 网 格 ， 我 们 使 用 mgird 对 象 创 建 这 两 个 数组 。 

程序 的 运行 结果 如 图 3-7 所 示 。 左 图 为 函数 曲面 的 真实 值 ， 右 图 为 径 向 基 函 数 插值 算法 通 
过 曲面 上 的 随机 点 重建 的 曲面 ( 见 封 二 彩 插 )。 


1.8 


a@.5 


-8.5 


1 -9.5 6.9 6.5 1.81 和 .6 -0.5 6.6 9.5 1.6 
图 3-7 使 用 径 向 基 函 数 插值 算法 对 随机 取样 点 进行 二 维 插值 


3.4 数值 积分 一 integrate 


SciPy 的 integrate 模块 提供 了 几 种 数值 积分 算法 ， 其 中 包括 对 常 微分 方程 组 (ODE) 的 数值 
积分 。 本 节 以 计算 球体 体积 和 洛 伦 茨 吸引 子 轨迹 为 例 介绍 integrate 模块 的 用 法 。 


3.4.1 球 的 体积 


数值 积分 是 对 定 积分 的 数值 求解 ， 例 如 可 以 利用 数值 积分 计算 某 个 形状 的 面积 。 先 考虑 一 
下 如 何 计算 半径 为 1 的 半圆 的 面积 。 根 据 圆 的 面积 公式 ， 其 面积 应 该 等 于 x/2 。 单 位 半圆 的 曲 
线 方程 为 y= V1-x* ， 可 以 通过 下 面 的 half_circle0 进 行 计算 : 


a scipy_integrate.py 
用 数值 积分 求 圆 的 面积 和 球 的 体积 


def half circle(x): 
return (1-x**2)**@.5 


最 简单 的 数值 积分 算法 就 是 将 要 积分 的 面积 分 为 许多 小 矩形 , 然后 计算 这 些 矩 形 的 面积 之 
和 。 下 面 使 用 这 种 方法 ， 将 和 轴 上 -1 到 1 的 区 间 分 为 10000 等 份 ， 然 后 计算 面积 和 : 


>>> N = 16666 
>>> x = np.linspace(-1, 1, N) 
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>>> dx = x[1] - x[6] 

>>> y = half_circle(x) 

>>> 2 * dx * np.sum(y) # 面积 的 两 倍 
3.1415893269387378 


也 可 以 用 NumPy 的 trapzO 计 算 半圆 上 由 各 点 构成 的 多 边 形 的 面积 : 


>>> np.trapz(y，x) * 2 # 面积 的 两 倍 
3.1415893269316642 


trapz0 计 算 的 是 以 (x,y) 为 顶点 坐标 的 折线 与 X 轴 所 夹 的 面积 。 
如 果 使 用 SciPy 的 integrate 模块 中 的 数值 积分 函数 quad0， 将 能 得 到 非常 精确 的 结果 : 


>>> from scipy import integrate 

>>> pi_half, err = integrate.quad(half_circle，-1，1) 
>>> pi_half*2 

3.1415926535897984 


计算 多 重 定 积分 可 以 通过 多 次 调用 quad0 来 实现 ， 为 了 调用 方便 ，integrate 模块 提供 了 
dblquad0 以 进行 二 重 定 积分 ， 以 及 tplquad0 用 于 进行 三 重 定 积 分 。 下 面 以 计算 单位 半球 体积 为 
例 ， 说 明 dblquad0 的 用 法 。 

单位 半球 面 上 的 点 (xy.Z) 满 足 如 下 方程 : 

x2+J2+32 =1 


因此 下 面 的 half sphereO 可 以 通过 X-Y 轴 坐 标 计算 球面 上 点 的 Z 轴 坐 标 值 : 


def half_sphere(x, y): 
return (1-x**2-y**2)**0.5 


X-Y 轴 平 面 与 此 球体 的 交 线 为 一 个 单位 圆 ， 因此 二 重 积分 的 计算 区 间 为 此 单位 圆 。 即 对 于 
和 轴 从 -1 到 1 进行 积分 ,而 对 于 Y 轴 则 从 -half_circle(x) 到 half_circle(x) 进 行 积 分 。 因 此 半球 体 
积 的 二 重 积分 公式 为 : 


1 Ve 


| 1—x?— ydydx 
= 


下 面 的 程序 使 用 dblquad0 计 算 半 球体 积 : 


>>> integrate.dblquad(half_sphere，-1，1， 
lambda x:-half_circle(x)， 
lambda x:half_circle(x)) 

>>> (2.9943951623931988，2.3252456653396915e-14) 


>>> np.pi*4/3/2 # 通过 球体 体积 公式 计算 半球 体积 
2.6943951623931953 


dblquad0 的 调用 参数 为 : 
dblquad(func2d, a, b, gfun, hfun) 


其 中 ，func2d 是 需要 进行 二 重 积 分 的 函数 ， 它 有 两 个 参数 ， 假 设 分 别 为 x 和 y。a 和 b 参 
数 指定 被 积分 函数 的 第 一 个 变量 ( 即 x) 的 积分 区 间 ， 而 gfan 和 hfim 参数 指定 第 二 个 变量 ( 即 y) 
的 积分 区 间 。gfun 和 hfun 是 函数 , 它们 通过 变量 x 计算 出 变量 y 的 积分 区 间 , 这 样 可 以 在 X-Y 
平面 上 的 任何 区 间 对 func2d 进行 积分 。 

图 3-8 是 半球 体积 的 积分 示意 图 。 从 此 示意 图 可 以 看 出 ，X 轴 的 积分 区 间 为 -1.0 到 1.0， 
对 于 义 轴 上 的 菜 点 x0， 通 过 对 Y 轴 的 积分 可 以 计算 出 图 中 深 色 的 垂直 切面 的 面积 ， 因 此 Y 轴 
的 积分 区 间 如 图 中 的 点 线 所 示 。 


To ~100 


图 3-8 ”半球 体积 的 双重 定 积分 示意 图 


3.4.2 ” 解 常 微 分 方程 组 


integrate 模块 还 提供 了 对 常 微分 方程 组 进行 积分 的 函数 odeint0。 下面 我 们 看 看 如 何 用 它 计 
算 洛 伦 茨 吸 引子 的 轨迹 。 洛 伦 茨 吸引 子 由 下 面 的 三 个 微分 方程 定义 : 
dx 


s Ls RE 
Wp 3) ww FF 


http://bzhang.lamost.org/website/archives/lorenz_attactor 
洛 伦 茨 吸引 子 的 详细 介绍 


| 


这 三 个 方程 定义 了 三 维 空间 中 各 个 坐标 点 上 的 速度 矢量 。 从 某 个 坐标 开始 沿 着 速度 矢量 进 
行 积分 ， 就 可 以 计算 出 无 质量 点 在 此 空间 中 的 运动 轨迹 。 其 中 ，o、p、 为 三 个 常数 ， 不 同 的 
参数 可 以 计算 出 不 同 的 运动 轨迹 : x(D、y(D、z(D。 当 参数 为 某 些 值 时 ， 轨 迹 出 现 混沌 现象 。 即 
微小 的 初 值 差别 也 会 显著 地 影响 运动 轨迹 。 下 面 是 洛 伦 茨 吸 引子 的 轨迹 计算 和 绘制 程序 : 
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ww Scipy_odeint lorenz.py 
使 用 odeint 计算 洛 伦 茨 吸引 子 轨迹 


from scipy.integrate import odeint 
import numpy as np 
def lorenz(w, t, p, r, b): © 
# 给 出 位 置 矢量 w， 以 及 三 个 参数 p、r、b， 计 算出 dx/dt、dy/dt、dz/dt 的 值 
x, y, ZzZ = WwW.tolist() 
# 直接 与 lorenz 的 计算 公式 对 应 
return p*(y-x), x*(r-z)-y, x*y-b*z 
t = np.arange(9，386，6.61) # 创建 时 间 点 
# 调用 ode 对 lorenz 进行 求解 ， 用 两 个 不 同 的 初始 值 
trackl = odeint(lorenz, (8.0, 1.60, 8.0), t, args=(10.0, 28.0, 3.0)) © 
track2 = odeint(lorenz, (6.6, 1.61, 0.0), t, args=(10.0, 28.0, 3.0)) © 


# 绘图 

from mpl_toolkits.mplot3d import Axes3D @ 
import matplotlib.pyplot as plt 

fig = plt.figure() 

ax = Axes3D(fig) 

ax.plot(track1[:,80], tracki[:,1], track1[:,2]) 
ax.plot(track2[:,80], track2[:,1], track2[:,2]) 
plt.show() 


@ 程 序 中 首先 定义 一 个 函数 lorenz0， 它 的 任务 是 计算 出 某 个 坐标 点 在 各 个 方向 上 的 微分 
值 ， 可 以 直接 根据 洛 伦 茨 吸引 子 的 公式 得 出 。 

@@ 使 用 不 同 的 位 移 初始 值 两 次 调用 odeint0， 对 微分 方程 求解 。odeint0 有 许多 参数 ， 这 
里 用 到 的 4 个 参数 分 别 为 : 

e lorenz: 它 是 计算 某 个 位 置 上 各 个 方向 的 速度 的 函数 。 

e (0.0, 1.0, 0.0): 位 置 初始 值 ， 它 是 计算 常 微分 方程 所 需 的 各 个 变量 的 初始 值 。 

e t: 表示 时 间 的 数组 ，odeint0 对 此 数组 中 的 每 个 时 间 点 进行 求解 ， 得 出 所 有 时 间 点 的 

位 置 。 

e args: 这 些 参数 直接 传递 给 lorenz0， 因 此 它们 在 整个 积分 过 程 中 都 是 常量 。 

@ 最 后 通过 matplotlib 的 三 维 绘图 模块 "绘制 出 odeint0 后 得 到 的 轨迹 。 如 图 3-9 所 示 , 即使 
初始 值 只 相差 0.01， 两 条 运动 轨迹 也 是 完全 不 同 的 。 


@@ 有 关 matplotlib 的 三 维 绘图 模块 将 在 5.4.7 节 中 进行 介绍 。 


吕 昌 出 起 
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图 3-9 用 odeint0 对 洛 伦 茨 吸引 子 微分 方程 进行 数值 求解 后 得 到 的 运动 轨迹 


3.$ ”信号 处 理 一 一 signal 


SciPy 的 signal 模块 提供 了 许多 信号 处 理 方面 的 函数 ， 包 括 卷 积 运算 、B 样 条 、 滤 波 以 及 
滤波 器 设计 等 方面 的 内 容 。 本 节 简 单 介绍 中 值 滤波 和 IIR 带 通 滤波 器 的 设计 。 


3.5.1 中 值 滤波 


中 值 滤波 能 够 比较 有 效 地 消除 声音 信号 中 的 瞬间 噪声 或 者 图 像 中 的 斑点 噪声 。 在 signal 模 
块 中 ，medfilt0 对 一 维 信号 进行 中 值 滤波 ， 而 medfilt2d0 对 二 维 信号 进行 中 值 滤波 。 在 scipy. 
ndimage 模块 中 ， 另 有 针对 多 维 图 像 的 中 值 滤波 器 ， 这 里 简单 演示 medfilt0 中 值 滤波 的 效果 。 


办 scipy_signal noise filter.py 
人 于 用 中 值 滤波 剔除 瞬间 噪声 
首先 导入 signal 模块 : 
>>> import scipy.signal as signal 
然后 创建 一 个 带 有 随机 的 瞬间 噪声 的 正弦 波 : 


>>> t = np.arange(0, 20, 0.1) 
>>> x = np.sin(t) 
>>> x[np.random.randint(0, len(t), 20)] += np.random.standard_normal(26)*6.6 


调用 medfilt0 进 行 中 值 滤波 : 


>>> x2 = signal.medfilt(x, 5) 


调 粮 半 启 闫 一 Ad!?S 


% 
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第 二 个 参数 为 计算 中 值 的 窗口 大 小 ， 它 必须 是 一 个 奇数 。medfilt0 将 信号 中 的 每 个 元 素 都 


蔡 换 为 其 窗口 内 的 中 值 。 
最 后 绘制 原始 信号 和 滤波 信号 ， 为 了 便于 比较 ， 图 3-10 中 将 滤波 之 后 的 信号 统一 向 上 偏 


移 了 0.5( 见 封 二 彩 插 )。 


2 5 这 5 区 


图 3-10 使 用 中 值 滤波 剔除 瞬间 噪声 
中 值 滤波 是 排序 滤波 的 一 个 特例 。 使 用 排序 滤波 可 以 将 元 素 蔡 换 为 其 窗口 内 指定 排序 顺序 
的 元 素 。 其 调用 形式 如 下 : 
order_filter(a, domain, rank) 


其 中 : a 是 一 个 多 维 数组 ，domain 是 维 数 和 a 相同 的 数组 ， 它 指定 窗口 的 范围 ，rank 是 一 
个 非 负 整数 ， 用 来 选择 窗口 中 元 素 排序 后 的 值 ，0 表示 选择 最 小 值 ，1 表示 选择 第 二 小 的 值 。 
中 值 滤波 也 可 以 用 order_filter0 来 计算 , 注意 domain 参数 是 一 个 长 度 为 5、 值 全 为 1 的 数组 : 


>>> x3 = signal.order filter(x, np.ones(5), 3) 
>>> np.all(x2==x3) 
True 


; A scipy_signal_order filter.py 
守 _ order filter 用 法 演示 
3.5.2 ”滤波 器 设计 

signal 模块 提供 了 许多 滤波 器 设计 的 函数 。 在 下 面 的 实例 中 ， 我 们 设计 一 个 IR 带 通 滤波 
器 ， 并 查看 其 频率 响应 ， 最 后 使 用 它 对 频率 扫描 信号 进行 滤波 计算 。 


5 A scipy_signal bandpass.py 
窑 一 设计 带 通 IIR 滤波 器 并 用 频率 扫描 波 测试 其 频率 响应 


首先 用 iirdesign0 设 计 一 个 IR 带 通 滤波 器 : 


>>> b, a = signal.iirdesign([6.2，6.5]，[6.1，6.6]，2，46) 


这 个 滤波 器 的 通 带 为 0.2 到 0.5 万 ， 阻 带 为 小 于 0.1 万 和 大 于 0.6 万 ， 其 中 万 为 信号 取样 频 
率 的 一 半 。 如 果 取 样 频率 为 8k Hz， 那 么 这 个 带 通 滤波 器 的 通 带 为 800 Hz 到 2k Hz。 通 带 的 最 
大 增益 衰减 为 2 dB， 阻 带 的 最 小 增益 衰减 为 40 dB， 即 通 带 的 增益 浮动 在 2 dB 之 内 ， 阻 带 至 少 
有 40 dB 的 衰减 。 

iirdesgin0 返 回 两 个 数组 b 和 a, 它们 分 别 是 IR 滤波 器 的 分 子 和 分 母 部 分 的 系数 。 其 中 a[0] 
恒 等 于 1。 下 面 通过 调用 freqz0 计 算 所 得 到 的 滤波 器 的 频率 响应 : 


>>> WwW h = signal.freqz(b, a) 


freqz0 返 回 两 个 数组 w 和 h， 其 中 w 是 圆 频率 数组 ， 通 过 cy /7 可 以 计算 出 其 对 应 的 实际 
频率 。h 是 w 中 对 应 频率 点 的 响应 ， 它 是 一 个 复数 数组 ， 其 幅 值 表示 滤波 器 的 增益 特性 ， 相 角 
表示 滤波 器 的 相位 特性 。 

下 面 计算 h 的 增益 特性 ， 并 使 用 dB 进行 度量 。 由 于 h 中 存在 幅 值 几乎 为 0 的 值 ， 因 此 先 
用 clip0 对 其 裁 前 之 后 ， 再 调用 对 数 函数 ， 避 免 计 算出 错 。 


>>> power = 269*np.1og16(np.clip(np.abs(h)，1le-8，1le166)) 


通过 下 面 的 语句 可 以 绘制 出 如 图 3-11( 上 ) 所 示 的 滤波 器 增益 特性 ， 这 里 假设 取样 频率 为 
8k Hz: 


>>> import pylab as pl 
>>> pl1.plot(w/np.pi*4666，power) 


在 实际 运用 中 ,为 了 测量 未 知 系统 的 频率 特性 ， 经 常 将 频率 扫描 波 输入 到 系统 中 ， 观 察 系 
统 的 输出 ， 从 而 计算 其 频率 特性 。 下 面 模拟 这 一 过 程 。 

为 了 调用 chimp0 产 生 频率 扫描 波形 的 数据 ， 首 先 需要 产生 一 个 表示 取样 时 间 的 等 差 数组 。 
下 面 的 语句 产生 2 秒 钟 、 取 样 频率 为 8k Hz 的 取样 时 间 数 组 


>>> t = np.arange(86，2，1/8666.6) 


然后 调用 chirp0 得 到 2 秒 钟 的 频率 扫描 波形 的 数据 。 频 率 扫描 波 的 开始 频率 人 0 为 0 Hz， 
结束 频率 也 为 4k Hz， 到 达 4k Hz 的 时 间 为 2 秒 ， 使 用 数组 t 作为 取样 时 间 点 。 


>>> sweep = signal.chirp(t, f@=0, t1 = 2，f1=4666.6) 
最 后 调用 lfilter0 计 算 频 率 扫描 波形 经 过 带 通 滤波 器 之 后 的 结果 : 
>>> out = signal.lfilter(b, a, sweep) 


为 了 和 系统 的 增益 特性 图 进行 比较 ,需要 获取 输出 波形 的 包 络 ， 因 此 下 面 先 将 输出 波形 数 
据 转换 为 能 量 值 : 


>>> out = 26+np.1og16(np.abs(out)) 
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为 了 计算 包 络 ， 找 到 所 有 能 量 大 于 前 后 两 个 取样 点 (局 部 最 大 点 ) 的 下 标 : 

>>> index = npwhere(np.logical_and(out[1:-1] > out[:-2], out[1:-1] > out[2:]))[e] + 1 
最 后 将 时 间 转 换 为 对 应 的 频率 ， 绘 制 所 有 局 部 最 大 点 的 能 量 值 : 

>>> pl.plot(t[index]/2.0*4000, out[index] ) 


3-11 显示 了 freqz0 计 算 的 频谱 和 频率 扫描 波 得 到 的 频率 特性 ， 可 以 看 出 结果 是 一 致 的 。 
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图 3-11 带 通 IIR 滤波 器 的 频率 响应 和 频率 扫描 波 计算 的 结果 比较 


3.6 图 像 处 理 一 一 ndimage 


scipy.ndimage 是 一 个 处 理 多维 图 像 的 函数 库 ， 其 中 又 包括 以 下 几 个 模块 : 

e filters: 图 像 滤 波 器 

e fourier: 傅 里 叶 变换 

e interpolation: 图 像 的 插值 、 旋 转 及 仿 射 变换 等 

。 measurements: 图 像 相关 信息 的 测量 

。 morphology: 形态 学 图 像 处 理 

本 节 介 绍 如 何 使 用 morphology 模块 实现 二 值 图 像 处 理 。 二 值 图 像 中 每 个 像素 的 颜色 只 有 
两 种 : 黑色 和 白色 。 在 NumPy 中 可 以 用 二 维 布尔 数组 表示 : False 表示 黑色 ，True 表示 白色 。 
也 可 以 用 无 符号 单字 节 整 型 (uint8) 数 组 表示 : 0 表示 黑色 ，255 表示 白色 。 


3.6.1 膨胀 和 腐蚀 


二 值 图 像 最 基本 的 形态 学 运算 是 膨胀 和 腐蚀 。 膨 胀 运算 是 将 与 菜 物体 (白色 区 域 ) 接 触 的 所 
有 背景 像素 (黑色 区 域 ) 合 并 到 该 物体 中 的 过 程 。 简 单 地 说 ， 就 是 对 原始 图 像 中 的 每 个 白色 像素 
进行 处 理 ， 将 其 周围 的 黑色 像素 都 设置 为 白色 像素 。 这 里 的 “周围 ”是 一 个 模糊 概念 ， 在 实际 
运算 时 , 需要 明确 给 出 “周围 ”的 定义 。 图 3-12 是 膨胀 运算 的 一 个 例子 , 其 中 左 图 是 原始 图 像 ， 
中 间 的 图 是 四 连通 定义 的 “周围 ”的 膨胀 效果 ， 右 图 是 八 连通 定义 的 “周围 ”的 膨胀 效果 。 图 
中 用 灰色 方块 表示 由 膨胀 处 理 添加 进 物体 的 像素 。 


scipy_image_dilation.py 
全 一 ”膨胀 运算 效果 演示 


图 3-12 原始 图 像 ( 左 )、 四 连通 膨胀 (中 )、 八 连通 膨胀 ( 右 ) 
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四 连通 包括 上 下 左右 4 个 像素 ， 而 八 连通 则 还 包括 4 个 斜 线 方向 上 的 邻接 像素 。 它 们 都 可 
以 使 用 下 面 的 正方 形 矩 阵 来 定义 ， 其 中 正中 心 的 元 素 表示 当前 要 进行 运算 的 像素 ， 而 其 周围 的 
1 和 0 表示 对 应 位 置 的 像素 是 否 算 其 “周围 ”像素 。 这 种 矩阵 描述 了 周围 像素 和 当前 像素 之 间 | 
的 关系 ， 被 称 为 结构 元 素 (structuring element)。 


四 连通 八 连通 
010 LL 
be 1 
8 Ti 


假设 数组 a 是 一 个 表示 二 值 图 像 的 数组 ， 可 以 用 如 下 语句 对 其 进行 膨胀 运算 ， 


>>> import scipy.ndimage.morphology as m 
>>> b = m.binary_dilation(a) 


binary dilation0 默 认 使 用 四 连通 进行 膨胀 运算 ， 通 过 structure 参数 可 以 指定 其 他 的 结构 元 
素 。 下 面 是 进行 八 连通 膨胀 运算 的 语句 : 


>>> c = m.binary_dilation(a，structure=[[1,1,1],[1,1,1],[1,1,1]]) 


通过 设置 不 同 的 结构 元 素 ， 能 够 制作 出 各 种 不 同 的 效果 。 图 3-13 显示 了 三 种 不 同 结构 元 素 
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的 膨胀 效果 ， 图 中 的 结构 元 素 分 别 为 : 


左 中 右 
000 O10 0160 
是 
e606 616 0660600 


图 3-13 不 同 的 结构 元 素 产生 不 同 的 膨胀 效果 


binary_erosion0 的 腐蚀 运算 正好 和 膨胀 运算 相反 ， 它 将 “周围 ”有 黑色 像素 的 白色 像素 设 
置 为 黑色 。 图 3-14 是 四 连通 和 八 连 通 腐蚀 的 效果 ， 图 中 用 灰色 方块 表示 被 腐蚀 的 像素 。 


scipy_image erosion.py 


六 腐 作 运算 效果 演示 


图 3-14 原始 图 像 ( 左 )、 四 连通 腐蚀 (中 )、 八 连通 腐蚀 ( 右 ) 


3.6.2 Hit 和 Miss 


Hit 和 Miss 是 二 值 形态 学 图 像 处 理 中 最 基本 的 运算 ， 因 为 几乎 所 有 其 他 的 运算 都 可 以 用 
Hit 和 Miss 的 组 合 推演 出 来 。 它 对 图 像 中 每 个 像素 周围 的 像素 进行 模式 判断 ， 如 果 周 围 像素 的 
黑白 模式 符合 指定 的 模式 ， 就 将 此 像素 设 为 白色 ， 否 则 设 为 黑色 。 因 为 它 需要 同时 对 白色 和 黑 
色 像素 进行 判断 ， 因 此 需要 指定 两 个 结构 元 素 。 进 行 Hit 和 Miss 运算 的 binary hit or miss0 的 
调用 形式 如 下 : 


binary_hit or miss(input, structurel=None, structure2=None, ...) 


其 中 ，structurel 参数 指定 白色 像素 的 结构 元 素 ，structure2 参数 则 指定 黑色 像素 的 结构 元 


素 。 图 3-15 是 binary hit or miss0 的 运算 结果 。 其 中 ， 左 图 为 原始 图 像 ， 中 图 为 使 用 下 面 两 个 
结构 元 素 进行 运算 的 结果 : 


白色 结构 元 素 。 黑色 结构 元 素 


e600 166 
eile e000 
ER 98686686 


在 这 两 个 结构 元 素 中 ，0 表示 不 关心 其 对 应 位 置 的 像素 的 颜色 ，1 表示 其 对 应 位 置 的 像素 
必须 为 结构 元 素 所 表示 的 颜色 。 因 此 ， 通 过 这 两 个 结构 元 素 可 以 找到 “下 方 三 个 像素 为 白色 ， 
并 且 左 上 方 像素 为 黑色 的 白色 像素 ”。 

与 图 3-15( 右 ) 对 应 的 结构 元 素 如 下 ， 通 过 它 可 以 找到 “下 方 三 个 像素 为 白色 、 左 上 方 像素 
为 黑色 的 黑色 像素 ”: 


白色 结构 元 素 。 黑色 结构 元 素 


a@00 196 
869 eile 
e000 


scipy_image_hitmiss.py 
Hit 和 Miss 运算 的 效果 演示 


图 3-15 Hit 和 Miss 运算 的 效果 演示 


使 用 Hit 和 Miss 运算 的 组 合 , 可 以 实现 很 复杂 的 图 像 处 理 。 例如 文字 识别 中 常用 的 细 线 化 
运算 ， 就 可 以 用 一 系列 的 Hit 和 Miss 运算 来 实现 。 图 3-16 显示 了 细 线 化 处 理 的 效果 。 


TES 


图 3-16 使 用 Hit 和 Miss 运算 实现 细 线 化 处 理 


细 线 化 算法 的 实现 程序 如 下 ， 这 里 只 列 出 其 中 真正 进行 细 线 化 算法 的 函数 skeletonize0: 


半 启 光一 /AdI2S 


贡 


103 


贡 业 才 启 只 一 人 doS 


Python 科学 计算 


¥# scipy_image_ skeletonization py 
六 二 使 用 Hit 和 Miss 运算 实现 细 线 化 处 理 效果 


def skeletonize(img): 
hl = np.array([[9, e, 8],[9, 1, 9],[1, 1, 1]]) © 
m = np.array([[1, 1, 1],[9, 8, 8],[e, 8, 8]]) 
h2 = np.array([[9, 8@, 8],[1, 1, 8],[e, 1, 9]]) 
m2 = np.array([[e@, 1, 1],[9, 9, 1],[9, 9, 9]]) 
hit list = [] 
miss_list = [] 
for k in range(4): @ 
hit_1list.append(np.rot96(h1，k)) 
hit_list.append(np.rot96(h2，k)) 
miss_list.append(np.rot98(m1，k)) 
miss_1ist.append(np.rot98(m2，k)) 
img = img.copy() 
while True: 
last = img 
for hit, miss in zip(hit list, miss_ list): 
hm = m.binary_hit or miss(img, hit, miss) © 
# 从 图 像 中 删除 hit_or_miss 所 得 到 的 白色 像素 
img = np.logical_and(img，np.1logical_not(hm)) @ 
# 如 果 处 理 之 后 的 图 像 和 处 理 前 的 图 像 相同 ， 就 结束 处 理 
if np.all(img == last): © 
break 
return img 


@ 以 图 3-17 所 示 的 两 个 结构 元 素 为 基础 ， 构 造 4 个 3*3 的 二 维 数组 : hl、ml、h2 和 m2。 
其 中 : hl 和 ml 对 应 图 中 左边 的 结构 元 素 ，h2 和 m2 对 应 图 中 右边 的 结构 元 素 ，hl 和 h2 对 应 
白色 结构 元 素 ，ml 和 m2 对 应 黑色 结构 元 素 。@ 将 这 些 结构 元 素 进行 900”、180”、270” 旋 
转 之 后 ， 一 共 得 到 8 个 结构 元 素 。 

人 @ 依 次 使 用 这 些 结构 元 素 进行 Hit 和 Miss 运算,@ 并 从 图 像 中 删除 运算 所 得 到 的 白色 像素 ， 
其 效果 就 是 依次 从 8 个 方向 删除 图 像 边缘 上 的 像素 。@ 重 复 运算 直到 没有 像素 可 删除 为 止 。 


右 色 结构 元 审 白色 二 9 元 让 
01010 0[010 

| | 
olio 有 | 黑 黑 | 黑 | 黑 | 黑 jiio| 
iil: 上 oilo| 

白 ”| 白白 黑 

1[i[1 Nolili) 
0 .00 门口 四 
9101o 中 白白 | 白 | 已 Mololol 
源 色 直 构 元 素 出 色 培 构 元 素 


图 3-17 细 线 化 算法 的 4 个 结构 元 素 


3.7 ”统计 一 一 stats 


Scipy 的 stats 模块 包含 了 多 种 概率 分 布 的 随机 变量 ”"， 随 机 变量 分 为 连续 的 和 离散 的 两 种 。 
所 有 的 连续 随机 变量 都 是 rv_continuous 的 派生 类 的 对 象 ， 而 所 有 的 离散 随机 变量 都 是 
IV_discrete 的 派生 类 的 对 象 。 


3.7.1 连续 和 离散 概率 分 布 
可 以 使 用 下 面 的 语句 获得 stats 模块 中 所 有 的 连续 随机 变量 : 


>>> from scipy import stats 

>>> [k for k,v in stats. dict .items() if isinstance(v, stats.rv_continuous)] 
[ "genhalflogistic'，triang'，rayleigh'，betaprime"，...] 

连续 随机 变量 对 象 都 有 如 下 方法 : 

e IVs: 对 随机 变量 进行 随机 取 值 ， 可 以 通过 size 参数 指定 输出 的 数组 大 小 。 

。 pdf; 随机 变量 的 概率 密度 函数 。 

。 cdf: 随机 变量 的 累积 分 布 函数 ， 它 是 概率 密度 函数 的 积分 。 

e sf; 随机 变量 的 生存 函数 ， 它 的 值 是 1 - cdftb。 

e ppf: 累积 分 布 函 数 的 反 函 数 。 

。 stat: 计算 随机 变量 的 期 望 值 和 方差 。 

e fit: 对 一 组 随机 取样 进行 拟 合 ， 找 出 最 适合 取样 数据 的 概率 密度 函数 的 系数 。 


7 scipy_stats.py 


概率 密度 函数 、 直 方 图 统计 和 累积 分 布 函 数 


下 面 以 正 态 分 布 为 例 ， 简 单 介绍 随机 变量 的 用 法 。 下 面 的 语句 可 获得 默认 正 态 分 布 的 随机 
变量 的 期 望 值 和 方差 ， 可 以 看 到 ， 默 认 情况 下 它 是 一 个 均值 为 0、 方 差 为 1 的 随机 变量 


>>> stats.norm.stats() 
(array(6.9)，array(1.6)) 


norm 可 以 像 函 数 那样 来 调用 , 通过 loc 和 scale 参数 可 以 指定 随机 变量 的 偏 移 和 缩放 参数 。 
对 于 正 态 分 布 的 随机 变量 来 说 ， 这 两 个 参数 相当 于 指定 其 期 望 值 和 标准 差 : 
>>> X = stats.norm(loc=1.0, scale=2.0) 


>>> x.stats() 
(array(1.9)，array(4.9)) 


@@ 这 里 的 随机 变量 是 概率 论 中 的 概念 ， 不 是 Python 中 的 变量 。 
@ 标准 差 是 方差 的 算术 平方 根 ， 因 此 标准 差 为 20 时 ， 方 差 为 40。 
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下 面 调用 随机 变量 X 的 rvs( 方 法 , 得 到 包含 一 万 次 随机 取样 值 的 数组 x; 然后 调用 NumPy 
的 mean0 和 var0， 计 算 此 数组 的 均值 和 方差 ， 其 结果 符合 随机 变量 X 的 特性 : 


>>> x = X.rvs(size=19666) # 对 随机 变量 取 166686 个 值 
>>> np.mean(x) # 期 望 值 

1.9181259658732724 

>>> np.var(x) # 方差 

4.96188661646659 


也 可 以 使 用 fit0 方 法 对 随机 取样 序列 x 进行 拟 合 ， 返 回 的 是 与 随机 取样 值 最 吻合 的 随机 变 
量 的 参数 : 


>>> stats.norm.fit(x) # 得 到 随机 序列 的 期 望 值 和 标准 差 
array([ 1.91816691， 2.66646946]) 


接 下 来 比较 随机 变量 X 的 概率 密度 函数 和 对 数组 x 进行 直方 图 统计 的 结果 : 


>>> t = np.arange(-10, 10, 80.61) 

>>> p1.plot(t，X.pdf(t)) # 绘制 概率 密度 函数 的 理论 值 
>>> p, t2 = np.histogram(x，bins=166，normed=True) 
>>> t2 = (t2[:-1] + t2[1:])/2 

>>> pl.plot(t2，p) # 绘制 统计 所 得 到 的 概率 密度 


其 中 ，histogram0 对 数组 x 进行 直方 图 统计 ， 它 将 数组 x 的 取 值 范围 分 为 100 个 区 间 ， 并 
统计 x 中 每 个 值 落 入 各 个 区 间 中 的 次 数 。histogram0 返 回 两 个 数组 p 和 也 ， 其 中 p 表示 各 个 区 
间 取 样 值 出 现 的 频数 ， 由 于 normed 参数 为 True， 因 此 p 的 值 是 正规 化 之 后 的 结果 。t2 表示 区 
间 ， 由 于 其 中 包括 区 间 起 点 和 终点 ， 因 此 名 的 长 度 为 101。 图 3-18( 左 ) 显 示 了 概率 密度 函数 和 
直方 图 统计 的 结果 ， 可 以 看 出 二 者 是 一 致 的 。 

下 面 的 程序 绘制 随机 变量 X 的 累积 分 布 函数 和 数组 p 的 累加 结果 ， 其 结果 如 图 3-18( 右 ) 
所 示 。 


>>> pl.plot(t, X.cdf(t)) 
>>> pl.plot(t2, np.add.accumulate(p)*(t2[1]-t2[8])) 


8.25| 1,4 
1.9| 
| 
.9 
| 
.2| 


tr 品 Be 


图 3-18 正规 分 布 的 概率 密度 函数 ( 左 ) 和 累积 分 布 函 数 ( 右 ) 


站 <- 吕 地 


有 些 随机 分 布 除 了 loc 和 scale 参数 之 外 , 还 需要 额外 的 形状 参数 。 例 如 伽 玛 分 布 可 用 于 描 
述 等 待 大 个 独立 的 随机 事件 发 生 所 需 的 时 间 ， 大 就 是 伽 玛 分 布 的 形状 参数 。 下 面 计算 形状 参数 
大 为 1 和 2 时 伽 玛 分 布 的 期 望 值 和 方差 : 


>>> stats.gamma.stats(1.9) 
(array(1.6)，array(1.6)) 
>>> stats.gamma.stats(2.9) 
(array(2.6)，array(2.6)) 


伯 玛 分 布 的 尺度 参数 9 和 随机 事件 发 生 的 频率 相关 ， 由 scale 参数 指定 : 


>>> stats.gamma.stats(2.0, scale=2) 
(array(4.9)，array(8.9)) 


根据 伽 玛 分 布 的 数学 定义 可 知 其 期 望 值 为 59, 方差 为 kx9”。 上 面 的 程序 验证 了 这 两 个 公式 。 
当 随 机 分 布 有 额外 的 形状 参数 时 ， 它 所 对 应 的 rvs0、pdfO 等 方法 都 会 增加 额外 的 参数 以 接 
收 形状 参数 。 例 如 下 面 的 程序 调用 rvs0 对 厂 2,9=2 的 伽 玛 分 布 取 4 个 随机 值 : 


>>> x = stats.gamma.rvs(2, scale=2, size=4) 
>>> x 
array([ 2.20814648, 3.56652153， 4.36688176， 6.68262888]) 


接 下 来 调用 pdft0， 查 看 上 面 4 个 随机 值 所 对 应 的 概率 密度 : 


>>> stats.gamma.pdf(x, 2, scale=2) 
array([ 6.18361612， 6.1498734 ， 8.12519894， 89.12136919]) 


也 可 以 先 创建 将 形状 参数 和 尺度 参数 固定 的 随机 变量 ， 然 后 再 调用 其 pdfO 计 算 概率 密度 ; 


>>> X = stats.gamma(2, scale=2) 
>>> X.pdf(x) 
array([ 6.18361612， 6.1498734 ， 6.12519894， 89.12136919]) 


当 分 布 函数 的 值 域 为 离散 时 ， 我 们 称 之 为 离散 概率 分 布 。 例 如 投掷 有 6 个 面 的 般 子 时 ， 只 
能 获得 1 到 6 的 整数 ， 因 此 得 到 的 概率 分 布 为 离散 的 。 对 于 离散 随机 分 布 ， 通 常 使 用 概率 质量 
函数 (PMF) 描 述 其 分 布 情况 。 

在 stats 库 中 所 有 描述 离散 分 布 的 随机 变量 都 从 rv_discrete 类 继承 ,也 可 以 直接 用 rv_discrete 
类 自 定义 离散 概率 分 布 。 例 如 假设 有 一 个 不 均匀 的 角 子 ， 各 点 出 现 的 概率 不 相等 。 可 以 用 下 面 
的 数组 x 保存 山子 的 所 有 可 能 值 ， 数 组 p 保存 每 个 值 出 现 的 概率 : 


>>> x = range(1,7) 
>>> p = (0.4, 0.2, 0.1, 9.1, 0.1, 9.1) 
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于 是 ,可 以 用 下 面 的 语句 定义 表示 这 个 特殊 仍 子 的 随机 变量 ， 并 调用 其 rvs0 方 法 投掷 此 般 
子 20 次 ， 获 得 符合 概率 p 的 随机 数 : 


>>> dice = stats.rv_discrete(values=(x,p)) 
>>> dice.rvs(size=26) 
afray([2 瑟 5 2 2 A OOIRI 2 al) 


3.7.2 二 项 、 泊 松 、 伽 玛 分 布 


本 节 用 几 个 实例 程序 对 概率 论 中 的 二 项 分 布 、 泊 松 分 布 以 及 伽 玛 分 布 进行 一 些 实验 和 讨论 。 

二 项 分 布 是 最 重要 的 离散 概率 分 布 之 一 。 假设 有 一 种 只 有 两 个 结果 的 试验 ， 其 成 功 概率 为 
p， 那 么 二 项 分 布 描述 了 进行 n 次 这 样 的 独立 试验 而 成 功 次 的 概率 。 二 项 分 布 的 概率 质量 函 
数 公 式 如 下 : 

fkin,p)= re mi? 人 

例如 ， 可 以 通过 二 项 分 布 的 概率 质量 公式 计算 投掷 5 次 贫 子 出 现 3 次 6 点 的 概率 。 投 掷 一 
次 山子 ， 点 数 为 6 的 概率 ( 即 试验 成 功 的 概率 ) 为 p=1/6， 试 验 次 数 为 n=5。 使 用 二 项 分 布 的 概率 
质量 函数 pmfO 可 以 很 容易 计算 出 现 大 次 6 点 的 概率 。 和 概率 密度 函数 pdf0 类 似 ，pmf0 的 第 一 
个 参数 为 随机 变量 的 取 值 ， 后 面 的 参数 为 描述 随机 分 布 所 需 的 参数 。 对 于 二 项 分 布 来 说 ， 参 数 
分 别 为 n 和 jp, 而 取 值 范围 则 为 0 到 之 间 的 整数 。 下 面 的 程序 计算 为 0 到 6 所 对 应 的 概率 : 


>>> stats.binom.pmf(range(6), 5, 1/6.0) 
array([6.491878，8.461878，8.166751，6.632156，8.683215，8.666129]) 


由 结果 可 知 : 出 现 0 或 1 次 6 点 的 概率 为 40.2%， 而 出 现 3 次 6 点 的 概率 为 3.215%。 

在 二 项 分 布 中 ， 如 果 试 验 次 数 很 大 ， 而 每 次 试验 成 功 的 概率 p 很 小 ， 其 乘积 np 比较 适 
中 ， 那 么 试验 成 功 次 数 的 概率 可 以 用 泊 松 分 布 近似 描述 。 

在 泊 松 分 布 中 ， 使 用 4 描述 单位 时 间 ( 或 单位 面积 ) 内 随机 事件 的 平均 发 生 率 。 如 果 将 二 项 
分 布 中 的 试验 次 数 n 看 作 单位 时 间 内 所 做 的 试验 次 数 ， 那么 它 和 事件 出 现 概率 p 的 乘积 就 是 事 
件 的 平均 发 生 率 ， 即 41=np。 泊 松 分 布 的 概率 质量 函数 公式 如 下 : 


f(k:N)= 


下 面 的 程序 分 别 计算 二 项 分 布 和 泊 松 分 布 的 概率 质量 函数 ， 结 果 如 图 3-19 所 示 ， 可 以 看 
出 当 n 足够 大 时 ， 二 者 是 十 分 接近 的 ( 见 封 二 彩 插 )。 


a scipy_binom poisson.py 
比较 二 项 分 布 和 泊 松 分 布 的 概率 质量 函数 


程序 中 事件 平均 发 生 率 14 恒 等 于 10。 根据 二 项 分 布 的 试验 次 数 n， 计算 每 次 事件 出 现 的 概 
率 z=4 包 。 程 序 中 的 运算 部 分 大 致 如 下 : 


>>> _lambda = 16.9 

>>> k = np.arange(26) 

>>> possion = stats.poisson.pmf(k，_lambda) # 泊 松 分 布 

>>> binom166 = stats.binom.pmf(k，169，_lambda/166) ”# 二 项 分 布 n=168 
>>> binom1666 = stats.binom.pmf(k，1866，_lambda/1666) # 二 项 分 布 n=18668 
>>> np.max(np.abs(binom166-possion)) # 计算 最 大 误差 

8.806755311183353312 

>>> np.max(np.abs(binom1868-possion)) # n 为 1968 时 ， 误 差 较 小 

昌 .86663617546569699912 


n=169 fi=1989 


3-19 当 ] 足够 大 时 二 项 分 布 和 泊 松 分 布 近似 相等 


泊 松 分 布 适合 描述 单位 时 间 内 随机 事件 发 生 次 数 的 分 布 情况 。 例如 某 设施 在 一 定时 间 内 的 
使 用 次 数 ， 机 器 出 现 故障 的 次 数 ， 自 然 灾 害 发 生 的 次 数 等 等 。 

为 了 加 深 读 者 对 泊 松 分 布 概念 的 理解 ， 下 面 我 们 使 用 随机 数 模拟 泊 松 分 布 ， 并 与 其 概率 质 
量 函 数 进行 比较 ， 结 果 如 图 3-20 所 示 。 图 3-20 中 ， 事 件 每 秒 的 平均 发 生 次 数 为 10， 即 4=10。 
其 中 左 图 的 观察 时 间 为 1 000 秒 ， 而 右 图 的 观察 时 间 为 50 000 秒 ( 见 文 前 彩 插 )。 可 以 看 出 : 观 
察 时 间 越 长 ， 事 件 每 秒 发 生 的 次 数 就 越 符 合 泊 松 分 布 。 


2 scipy_poisson_sim.py 
之 ”模拟 泊 松 分 布 
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tine = 56986 


图 3-20 模拟 泊 松 分 布 


由 于 上 面 的 程序 中 包含 了 许多 绘图 方面 的 代码 ， 下 面 我 们 直接 在 IPython 中 介绍 泊 松 分 布 
的 模拟 过 程 。 首 先 定义 事件 发 生 率 4 和 观察 时 间 : 


>>> _lambda = 16 
>>> time = 16666 


可 以 用 Numpy 的 随机 数 生成 函数 rand0， 产 生平 均 分 布 于 0 到 time 之 间 的 _lambda*time 
个 事件 所 发 生 的 时 刻 。 由 于 rand0 产 生 的 是 0 到 1 之 间 的 平均 分 布 的 随机 数 ， 因 此 需要 对 其 结 
果 扩 大 time 倍 ; 


>>> 七 = np.random.rand(_lambda*time)*time 
用 histogram0 可 以 统计 数组 t 中 每 秒 之 内 事件 发 生 的 次 数 count: 


>>> count, time edges = np.histogram(t, bins=time, range=(0,time)) 
>>> count 
array([10, 9, 8, ..., 11, 10, 18]) 


根据 泊 松 分 布 的 定义 ，count 数组 中 数值 的 分 布 情况 应 该 符合 泊 松 分 布 。 下 面 统计 事件 次 
数 在 0 到 20 区 间 内 的 概率 分 布 。 当 histogram0 的 normed 参数 为 True 并 且 每 个 统计 区 间 的 长 度 
为 1 时 ， 其 结果 和 概率 质量 函数 相等 。 


>>> dist，count_edges = np.histogram(count, bins=20, range=(0,28), normed=True) 
>>> poisson = stats.poisson.pmf(x, _lambda) 

>>> np.max(np.abs(dist-possion)) # 最 大 误差 很 小 ， 符 合 泊 松 分 布 
8.6688356241637675766 


还 可 以 换 一 个 角度 看 随机 事件 的 分 布 问题 。 我 们 可 以 观察 相 邻 两 个 事件 之 间 时 间 间 隔 的 分 


布 情况 ， 或 者 隔 上 个 事件 的 时 间 间 隔 的 分 布 情况 。 根 据 概率 论 ， 事 件 之 间 的 时 间 间 隔 应 符合 爷 
玛 分 布 ， 由 于 时 间 间 隔 可 以 是 任意 数值 ， 因 此 伽 玛 分 布 是 一 种 连续 概率 分 布 。 伽 玛 分 布 的 概率 


密度 函数 公式 如 下 ， 它 描述 第 个 事件 发 生 所 需 的 等 待 时 间 的 概率 分 布 。T(K) 是 仰 玛 函数 ， 当 
让 为 整数 时 ， 它 的 值 和 的 阶乘 已 相等 。 
TED MteCa 

工人 D) 

下 面 的 程序 模拟 了 事件 的 时 间 间 隔 的 伽 玛 分 布 ， 结 果 如 图 3-21 所 示 。 图 3-21 中 的 观察 时 
间 为 1 000 秒 ， 平 均 每 秒 产生 10 个 事件 。 左 图 中 “k=1”， 它 表示 相 邻 两 个 事件 之 间 的 时 间 间 
隔 的 分 布 ， 而 “k=2” 则 表示 相隔 一 个 事件 的 两 个 事件 之 间 的 时 间 间 隔 的 分 布 ， 可 以 看 出 它们 
都 符合 伽 玛 分 布 ( 见 文 前 彩 插 )。 


J 了 CC) = 


a scipy_gamma sim.py 
模拟 伽 玛 分 布 


有 2 .4 8 [本 Ie MB Ht 06 Dl To 1 id 16 
时 间 辣 天 i 


3-21 ”模拟 伽 玛 分 布 


下 面 我 们 直接 在 Python 中 模拟 伽 玛 分 布 。 首 先 在 10 000 秒 之 内 产生 100 000 个 随机 事件 
发 生 的 时 刻 。 因 此 事件 的 平均 发 生 次 数 为 每 秒 10 次 : 


>>> _lambda = 16 
>>> time = 16666 
>>> 七 = np.random.rand(_lambda*time)*time 


为 了 计算 事件 前 后 的 时 间 间 隔 ， 需 要 先 对 随机 时 刻 进行 排序 : 
>>> t.sort() 
然后 分 别 计算 “k=1” 和 “k=2” 时 的 时 间 间 隔 : 


>>> s1 = t[1:] - t[:-1] # 相 邻 两 个 事件 之 间 的 时 间 间 隔 
3>> s2 = t[2:] = t[:-2] # 相 隔 一 个 事件 的 两 个 事件 之 间 的 时 间 间 隔 
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对 sl 和 s2 分 别 调用 histogram0 进 行 概 率 统计 , 设置 normed 为 True 可 以 直接 统计 概率 密度 : 


>>> dist1, x1 = np.histogram(s1，bins=166，normed=True) 

>>> dist2，x2 = np.histogram(s2，bins=166，normed=True) 

histogram0 返 回 的 第 二 个 值 为 统计 区 间 的 边界 , 采用 gamma.pdfO 计 算 伽 玛 分 布 的 概率 密度 
时 ， 使 用 各 个 区 间 的 中 值 进行 计算 。pdfO 的 第 二 个 参数 为 上 值 ，scale 参数 为 14 : 


>>> gammal = stats.gamma.pdf((x1[:-1]+x1[1:])/2, 1, scale=1.6/_lambda) 
>>> gamma2 = stats.gamma.pdf((x2[:-1]+x2[1:])/2，2，scale=1.6/_lambda) 
>>> np.max(np.abs(gammal - dist1)) 

8@.13557317865888141 

>>> np.max(np.abs(gamma2 - dist2)) 

8@.0887375836861794656 


由 于 概率 密度 函数 的 值 本 身 比 较 大 ， 因 此 上 面 的 误差 已 经 很 小 了 : 


>>> np.max(gammal), np.max(gamma2) 
(9.3483221586498537，3.6767953241613656) 


3.8 骨 入 C 语言 程序 一 一 weave 


Python 作为 动态 语言 ， 功 能 虽然 强大 ,但 它 在 数值 计算 方面 有 一 个 最 大 的 缺点 : 速度 不 够 
快 。 在 Python 级 别 的 循环 和 计算 的 速度 只 有 C 语言 程序 的 百 分 之 一 。 因 此 才 有 了 NumPy、SciPy 
这 样 的 扩展 库 ， 对 高 度 优化 的 C、Fortran 的 函数 库 进行 封装 ， 以 供 Python 程序 调用 。 如 果 这 
些 高 度 优化 的 函数 库 无 法 实现 我 们 的 算法 ， 就 必须 从 头 开始 编写 循环 、 进 行 数 值 运算 ， 那 么 用 
Python 来 做 显然 是 不 合适 的 。 因 此 SciPy 提供 了 快速 调用 C++ 语言 程序 的 方法 : weave 模块。 
下 面 的 程序 用 weave 模块 调用 C 语言 对 NumPy 的 数组 进行 求 和 运算 。 


ww scipy_weave_sum bentchmark py 
用 weave 模块 调用 C 语言 程序 来 加 快运 行 速度 


import scipy.weave as weave 
import numpy as np 
import time 


def my_sum(a): 
n=int(len(a)) 
code=""" 
int i; 


double counter; 

counter =0; 

for(i=@;i<n;i++){ 
counter=counter+a(i); 

直 


return_val=counter; 


err=weave.inline( 
code, ©@ 
Ta ie 


type_converters=weave.converters.blitz, © 
compiler="gcc" ©@ 
» 


return err 


a = np.arange(86，16666666，1.9) 
# 先 调用 一 次 my_sum，weave 会 自动 对 上 语言 进行 编译 ， 此 后 直接 运行 编译 之 后 的 代码 
my_sum(a) 
start = time.clock() 
for i in xrange(166): 

my_sum(a) # 直接 运行 编译 之 后 的 代码 
print "my_sum:", (time.clock() - start) / 196.9 
start = time.clock() 
for i in xrange(166): 

np.sum( a ) # numpy 中 的 sum， 其 实现 也 是 C 语 言 级 别 
print "np.sum:", (time.clock() - start) / 166.9 
start = time.clock() 


sum(a) # Python 内 部 函数 sum 通过 数组 a 的 迭代 接口 访问 每 个 元 素 ， 因 此 速度 很 慢 
print "sum:", time.clock() - start 


此 程序 在 笔者 计算 机 上 的 运行 结果 为 : 


my_sum: 8.9311653282622 
np.sum: 9.9312218492456 
Sum: 12.1358849726 


可 以 看 到 ， 用 weave 模块 编译 的 C 语言 程序 和 NumpPy 的 sum0 几 乎 一 样 快 ， 而 Python 的 
内 部 函数 sum0 使 用 数组 的 迭代 器 接口 进行 运算 ， 因 此 速度 是 Python 语言 级 别 的， 只 有 weave 
版 本 的 几 百 分 之 一 。 

@weave.inline0 的 第 一 个 参数 是 一 个 字符 串 ， 其 内 容 为 需要 执行 的 C++ 代码。@ 第 二 个 参 
数 是 一 个 列表 ， 它 告诉 inline0 把 Python 中 的 变量 a 和 n 传递 给 C++ 程序 ， 注 意 我 们 用 字符 串 
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表示 变量 名 。@converters.blitz0 是 一 个 类 型 转换 器 ， 将 NumPy 的 数组 类 型 转换 为 C++ 的 blitz 
类 。C++ 程 序 中 的 变量 a 不 是 一 个 数组 ， 而 是 blitz 对 象 ， 因 此 它 使 用 aG) 获 得 各 个 元 素 的 值 ， 
而 不 是 用 afij。@ 最 后 我 们 通过 compiler 参数 指定 采用 gcc 作为 C++ 编译 器 。 


如 果 在 编译 时 出 现 错误 信息 ， 请 在 命令 行 中 输入 "where gcc" 来 查看 MinGW 编译 器 的 
个 安装 路 径 。 如 果 路 径 中 存在 空格 或 中 文 ， 请 重新 安装 MinGW 编译 器 到 全 英文 的 无 空 
格 路 径 之 下 。 路 径 中 的 空格 或 中 文 可 能 会 使 Python 无 法 正确 调用 它 进行 编译 。 


在 本 书 的 实战 篇 ， 还 会 对 weave 模块 进行 详细 介绍 。 这 段 程序 让 我 们 先 吃 了 一 颗 定 心 丸 : 
尽管 使 用 Python 解决 你 手头 上 的 计算 问题 ,不必 在 乎 计算 速度 不 够 快 ,因为 我 们 可 以 很 容易 将 
需要 大 量 计算 的 部 分 使 用 C 语言 进行 改写 。 


SymPy 一 一 符号 运算 好 帮手 


SymPy 是 Python 的 数学 符号 计算 库 ， 用 它 可 以 进行 数学 表达 式 的 符号 推导 和 演算 。 本 章 
的 实例 程序 大 都 是 在 交互 式 环境 下 运行 。 建 议 读 者 使 用 isympy 运行 本 章 的 演示 程序 ，isympy 在 
IPython 的 基础 上 添加 了 数学 表达 式 的 直观 显示 功能 。 此 外 ， 启 动 时 还 会 自动 运行 下 面 的 程序 ; 


>>> from _ future__ import division 

>>> from sympy import * 

>>> x，y，Z = symbols('x,y,z') 

>>> k, m, Nn = symbols('k,m,n', integer=True) 
>>> f, g, h = map(Function, 'fgh') 


这 段 程序 首先 将 Python 的 除法 操作 符 “/” 从 整数 除法 改 为 普通 除法 。 然 后 从 SymPy 库 载 
入 所 有 符号 ， 并 且 定 义 了 三 个 通用 的 数学 符号 x、y、:=， 三 个 表示 整数 的 符号 上 m、n， 以 及 
三 个 表示 数学 函数 的 符号 fg、h。 

isympy 的 启动 程序 可 以 在 “Ci\Python26\Scripts” 下 找到 。 此 路 径 已 经 添加 进 了 系统 路 径 
中 ， 因 此 可 以 在 任何 位 置 启动 它 ， 例 如 可 以 使 用 Windows 的 运行 对 话 框 直接 运行 isympy。 


4.1 从 例子 开始 


在 详细 介绍 SymPy 的 语法 结构 和 各 种 运算 功能 之 前 , 让 我 们 先 通 过 两 个 实例 说 明 用 SymPy 
解决 符号 运算 问题 的 一 般 步骤 。 


4.1.1 封面 上 的 经 典 公式 

请 读者 看 一 下 本 书 封面 左上 角 的 那个 数学 公式 : 

er +1=0 

此 公式 被 称 为 欧 拉 恒等式 , 其 中 e 是 自然 常数 ,i 是 虚数 单位 ,x 是 圆周 率 。 此 公式 被 誉 为 
数学 中 最 奇妙 的 公式 ， 它 将 5 个 基本 数学 常数 用 加 法 、 乘 法 和 客运 算 联 系 起 来 。 下 面 我 们 用 
SymPy 验证 此 公式 。 

从 SymPy 库 载 入 的 符号 中 ，E 表示 自然 常数 ，I 表 示 虚 数 单位 ，pi 表示 圆周 率 ， 因 此 上 面 
的 公式 可 以 直接 如 下 计算 : 
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>>> E**(I*pi)+1 
8 


SymPy 除了 可 以 直接 计算 公式 的 值 之 外 , 还 可 以 帮助 我 们 做 数学 公式 的 推导 和 证 明 。 欧 拉 
恒等式 可 以 将 x 代入 下 面 的 欧 拉 公式 得 到 : 
Er=cosxt+isinx 


在 SymPy 中 可 以 使 用 expand0 将 表达 式 展开 ， 我 们 用 它 展开 e* 试 试看 : 


>>> expand( E**(I*x) ) 
exp(I*x) 


很 遗憾 没有 成 功 ， 只 是 换 了 一 种 写法 而 已 。 这 里 的 exp 是 SymPy 中 表示 自然 指数 函数 的 
类 。 当 expand0 的 complex 参数 为 True 时 ， 表 达 式 将 被 分 为 实数 和 虚数 两 个 部 分 : 


>>> expand(exp(I*x), complex=True) 
I*exp(-im(x))*sin(re(x)) + cos(re(x))*exp(-im(x)) 


这 次 将 表达 式 展开 了 ， 但 是 得 到 的 结果 相当 复杂 。 其 中 的 sin、cos、re、im 都 是 SymPy 
中 定义 的 表示 数学 函数 的 类 : re 是 取 实 数值 的 函数 ，im 是 取 虚 数值 的 函数 。 显 然 ，expand0 将 
x 当做 复数 了 。 为 了 指定 x 为 实数 ， 我 们 需要 重新 定义 x: 


>>> x = Symbol("x", real=True) 
>>> expand(exp(I*x), complex=True) 
I*sin(x) + cos(x) 


终于 得 到 了 我 们 需要 的 公式 ， 那 么 如 何 证 明 它 呢 ? 我 们 可 以 用 泰勒 多 项 式 对 其 进行 展开 : 


>>> tmp = series(exp(I*x)，x，68，16) 
>>> tmp 


TE RE EE 
24 120 720 5040 40320 362880 


ix +o(xl) 
将 数学 表达 式 转换 为 LaTeX 格式 
为 了 让 读者 更 清晰 、 直 观 地 查看 SymPy 的 计算 结果 ， 本 书 使 用 数学 公式 显示 较为 复杂 
的 结果 。 幸 好 NumpPy 提供 了 latex0， 可 以 将 表达 式 自动 转换 为 LaTeX 的 数学 公式 格式 ， 因 
此 这 些 复杂 的 数学 公式 不 需要 手工 输入 。 例 如 : 


>>> latex(exp(I*x)) 
$e^{\mathbf{\imath} x}$ 


series0 对 表达 式 进行 泰勒 级 数 展 开 。 我 们 看 到 展开 之 后 虚数 项 和 实数 项 交 蔡 出 现 。 根 据 欧 
拉 公 式 ， 虚 数 项 的 和 应 该 等 于 sin x 的 泰勒 展开 ， 而 实数 项 的 和 应 该 等 于 cos x 的 泰勒 展开 。 
下 面 获得 tmp 的 实 部 : 


>>> re(tmp) 


| We TL A A 1 8 10 
1 一 二 zx 十 一 并 一 党 站 x 十 Re(o(x 
要 24 720 40320 Kae 


下 面 对 cos (x) 进 行 泰勒 展开 ， 我 们 看 到 其 中 各 项 和 上 面 的 结果 是 一 致 的 。 
>>> series(cos(x), x, 8, 10) 


二 FE = 十 x* +o(x") 
24 720 40320 


下 面 获 得 tmp 的 虚 部 : 
>>> im(tmp) 


de ee ln ee +Im(o(x")) 
6 120 5040 362880 


下 面 对 sin (x) 进 行 泰勒 展开 ， 其 中 各 项 也 和 上 面 的 结果 一 致 。 
>>> series(sin(x), x, 8, 106) 


pe ,| 


2 i 


3 5 ——3 x +o(x") 
6 120 5040 362880 


由 于 站 展开 式 的 实 部 和 虚 部 分 别 等 于 cos x 和 sin x， 因 此 验证 了 欧 拉 公 式 的 正确 性 。 
4.1.2 ”球体 体积 


3.4 节 介绍 了 如 何 使 用 数值 定 积分 计算 球体 的 体积 , SymPy 中 的 integrate0 则 可 以 帮助 我 们 
进行 符号 积分 。 例 如 下 面 的 语句 用 integrate0 进 行 不 定 积分 运算 : 


>>> integrate(x*sin(x), x) 
-x*cos(x) + sin(x) 


如 果 指 定 变 量 x 的 取 值 范 围 ，integrate0 就 能 进行 定 积分 运算 : 


>>> integrate(x*sin(x), (x, 0, 2*pi)) 
-2*pi 


为 了 计算 球体 体积 ， 首 先 看 看 如 何 计算 圆 的 面积 ， 假 设 圆 的 半径 为 r， 则 圆 上 任意 一 点 的 
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YY 坐标 函数 为 : 
y(x)=yr x 
因此 可 以 直接 对 函数 y(y 在 -r 到 r 区 间 上 进行 定 积分 得 到 半圆 面积 : 


>>> x, y, r = symbols('x,y,r') 
>>> 2 * integrate(sqrt(r*r-x**2), (x, -r, r)) 
2*Integral((r**2 - x**2)**(1/2), (x, -r, r)) 


首先 需要 定义 运算 中 所 需 的 符号 ， 这 里 用 symbols0 一 次 创建 多 个 符号 。integrate0 没 有 计 
算出 积分 结果 ， 而 是 直接 返回 了 我 们 输入 的 算式 。 这 是 因为 SymPy 不 知道 + 是 大 于 0 的 , 重新 
定义 rz， 就 可 以 得 到 正确 答案 了 : 


>>> r = symbols('r', positive=True) 

>>> circle area = 2 * integrate(sqrt(r**2-x**2), (x, -r, r)) 
>>> circle area 

pi*r**2 


接 下 来 对 此 面积 公式 进行 定 积分 , 就 可 以 得 到 球体 的 体积 , 但 是 随 着 X 轴 坐 标的 变化 ， 对 
应 切面 的 半径 也 会 发 生变 化 。 假 设 X 轴 的 坐标 为 x， 球 体 的 半径 为 r， 那 么 x 处 球 的 切面 半径 
可 以 使 用 前 面 的 公式 y(x) 计 算出 。 因 此 需要 对 圆 的 面积 公式 circle_area 中 的 变量 + 进行 蔡 代 : 


>>> circle area = circle area.subs(r, sqrt(r**2-x**2)) 
>>> circle area 
pi*(r**2 - x**2) 


用 subs 进行 算式 替换 

subs0 可 以 将 算式 中 的 符号 进行 替换 ， 它 有 3 种 调用 方式 : 

@ expression.subs(x, y): 将 算式 中 的 x 替换 成 y。 

@ expression.subs({x:y,u:v}): 使 用 字典 进行 多 次 替换 。 

日 expression.subs([(x,y), (u,v)]): 使 用 列表 进行 多 次 替换 。 
请 注意 多 次 替换 是 顺序 执行 的 ， 因 此 : 


expression.sub([(x,y),(y,x)]) 
并 不 能 对 符号 x 和 y 进行 交换 。 


然后 对 circle_area 中 的 变量 x 在 区 间 -r 到 r+ 上 进行 定 积分 ， 就 可 以 得 到 球体 的 体积 公式 : 


>>> integrate(circle area, (x, -r, r)) 
‘Arpisre*3/3 


4.2 ”数学 表达 式 


本 节 详 细 介 绍 数 学 表达 式 的 结构 ， 虽 然 这 部 分 内 容 比 较 枯燥 。 但 只 有 了 解 表达 式 的 结构 ， 
才能 随心 所 欲 地 对 其 进行 处 理 ， 将 SymPy 运用 到 更 复杂 的 计算 中 。 


4.2.1 符号 


数学 符号 用 Symbol 对 象 表示 ， 符 号 对 象 的 name 属性 是 符号 名 ， 符 号 名 在 显示 由 此 符号 
构成 的 表达 式 时 使 用 。Symbol 对 象 和 Python 的 变量 没有 内 在 联系 ， 但 是 为 了 使 用 起 来 方便 ， 
通常 我 们 让 变量 名 和 符号 名 相同 。 为 了 快速 创建 符号 及 与 其 同名 的 变量 , 可 以 使 用 var0, 例如 : 


>>> var("x8,y9,x1,y1") 
(x@, ye, x1, y1) 


上 面 的 语句 创建 了 名 为 x0、y0、xl1、y1 的 4 个 Symbol 对 象 ， 同 时 还 在 当前 的 环境 中 创建 
了 4 个 同名 的 变量 来 分 别 表示 这 4 个 Symbol 对 象 。 因 为 符号 对 象 在 转换 为 字符 串 时 直接 使 用 
它 的 name 属性 ， 因 此 在 交互 式 环境 中 我 们 看 到 变量 x0 的 值 就 是 x0， 但 是 查看 变量 x0 的 类 型 
时 就 可 以 发 现 ， 它 实际 上 是 一 个 Symbol 对 象 。 

>>> x9 

X9 

>>> type(x6) 

<class “sympy.core.symbol.Symbol'> 

>>> x9.name 

X9 

>>> type(xe.name) 

<type 'str'> 


在 交互 式 环境 中 使 用 var0 能 够 快速 创建 变量 和 Symbol 对 象 ， 但 是 在 程序 中 使 用 它 容易 引 
起 混淆 ， 这 时 我 们 可 以 使 用 symbols0 创 建 Symbol 对 象 ， 再 将 它们 赋值 给 变量 : 


>>> xl,y1 = symbols("x1,y1") 
>>> type(x1) 
<class “sympy.core.Symbol.Symbol > 


当然 ， 如 果 不 嫌 麻 烦 也 可 以 直接 使 用 Symbol 类 创建 对 象 : 


>>> x2 = Symbol("x2") 
当 symbols0 的 符号 名 参数 中 没有 去 号 或 空格 时 , 它 将 为 每 个 字符 创建 一 个 Symbol 对 


象 。 例 如 symbols("abc") 将 创建 名 称 分 别 为 a、b、c 的 三 个 Symbol 对 象 。 此 功能 在 后 
续 版 本 中 可 能 会 被 删除 。 
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变量 名 和 符号 名 当然 也 可 以 是 不 一 样 的 ， 例 如 : 


>>> t = x9 

$3» 

x0 

>>> a,b = symbols("alpha,beta") 
>>> a, b 

(alpha, beta) 


数学 公式 中 的 符号 一 般 都 有 特定 的 假设 ， 例 如 m、n 通常 是 整数 ， 而 = 经 常 表示 复数 。 在 
用 var0、symbols0 或 Symbol0 创 建 Symbol 对 象 时 ， 可 以 通过 关键 字 参 数 指定 所 创建 符号 的 假 
设 条 件 ， 这 些 假设 条 件 会 影响 到 它们 所 参与 的 计算 。 例 如 ， 下 面 创建 了 两 个 整数 符号 mm 和 n， 
以 及 一 个 正 数 符号 x: 

>>> m, Nn = symbols("m,n", integer=True) 

>>> x = Symbol("x", positive=True) 


每 个 符号 都 有 许多 is * 属 性 ， 用 以 判断 符号 的 各 种 假设 条 件 。 在 了 Python 中 ， 使 用 自动 完 
成 功能 可 以 快速 查看 这 些 假设 的 名 称 ,注意 下 划 线 后 为 大 写字 母 的 属性 , 用 来 判断 对 象 的 类 型 ; 
而 全 小 写字 母 的 属性 ， 则 用 来 判断 符号 的 假设 条 件 。 


>>> x.is_ # 按 Tab 键 自动 完成 


x.is_Add x.is_bounded x.is_nonnegative 
x.is_Atom x.is_commutative x.is_nonpositive 
x.is_Derivative x.is_comparable x.is_nonzero 
x.is_Function x.is_complex x.is_number 
x.is_Integer x.is_composite x.is_odd 

x.is Mul x.is_even x.is_polynomial 
x.is_Number x.is finite x.is positive 
x.is_NumberSymbol x.is_hypergeometric x.is prime 
x.is_Order x.is_ imaginary x.is_ rational 
x.is_Piecewise x.is_infinitesimal x.is rational_ function 
x.is_Pow x.is_integer x.is real 
x.is_Rational x.is_irrational x.is_unbounded 
x.is Real x.is_negative x.is_zero 
x.is_Symbol x.is_noninteger 

>>> x.is_Symbol # x 是 一 个 符号 

True 

>>> x.is_positive # x 是 一 个 正 数 

True 

>>> x.is_imaginary # 因为 x 可 以 比较 大 小 ， 所 以 它 不 是 虚数 

False 

>>> x.is_complex # x 是 一 个 复数 ， 因 为 复数 包括 实数 ， 而 实数 包括 正 数 
True 


使 用 assumptions0 属性 可 以 快速 查看 所 有 的 假设 条 件 , 其 中 commutative 为 True 表示 此 符 
号 满足 交换 律 ， 其 余 的 假设 条 件 根据 英文 名 很 容易 知道 它们 的 含义 ， 这 里 就 不 再 详细 叙述 了 。 


>>> x.assumptions@ 
{commutative: True， 
complex: True， 
imaginary: False, 
negative: False, 
nonnegative: True， 
nonpositive: False， 
nonzero: True， 
positive: True， 
real: True， 

zero: False} 


在 SymPy 中 ， 所 有 的 对 象 都 从 Basic 类 继承 ， 实 际 上 这 些 is * 属 性 和 assumptions0 属性 都 
是 在 Basic 类 中 定义 的 : 


>>> Symbol.mro() 

[<class 'sympy.core.symbol.Symbol'>, 

<class 'sympy.core.basic.Atom' >， 

<class 'sympy.core.basic.Basic'>, 

<class 'sympy.core.assumptions.AssumeMeths'>, 
<type'object'>] 


4.2.2 数值 


为 了 实现 符号 运算 , 在 SymPy 内 部 有 一 整套 数值 运算 系统 。 因 此 SymPy 的 数值 和 Python 
的 整数 、 浮 点 数 是 完全 不 同 的 对 象 。 为 了 使 用 方便 ，SymPy 会 尽量 自动 将 Python 的 数值 类 型 
转换 为 SymPy 的 数值 类 型 。 此 外 ，SymPy 提供 了 一 个 S 对 象 用 于 进行 这 种 转换 。 在 下 面 的 例 
子 中 ， 当 有 SymPy 的 数值 参与 计算 时 ， 结 果 将 是 SymPy 的 数值 对 象 。 


>>> 1/2 + 1/3 # 结果 为 浮 点 数 

0.833333333333 

>>> S(1)/2 + 1/S(3) # 结果 为 sympy 的 数值 对 象 
5/6 


“5/6” 在 SymPy 中 使 用 Rational 对 象 表示 ， 它 由 两 个 整数 的 商 表示 ， 数 学 上 称 之 为 有 理 
数 。 也 可 以 直接 通过 Rational 创建 : 


>>> Rational(5，16) # 有 理 数 会 自动 进行 约 分 处 理 
1/2 
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实数 用 Real 对 象 表示 ， 它 和 标准 的 浮 点 数 类 似 ， 但 是 它 的 精度 (有 效 数字 ) 可 以 通过 参数 指 
定 。 由 于 在 浮 点 数 和 Real 对 象 内 部 都 使 用 二 进 制 的 方式 表示 数值 , 因此 它们 都 无 法 精确 表示 十 
进 制 中 的 精确 小 数 ， 例 如 0.1。 我 们 可 以 使 用 NO 函数 查看 浮 点 数 的 实际 数值 ， 例 如 下 面 的 语句 
查看 浮 点 数 0.1 和 10000.1 的 60 位 有 效 数 字 , 可 以 看 到 数值 的 绝对 精度 随 着 数值 的 增 大 而 减 小 : 


>>> N(8.1，66) 
8.166666666666686666855511151231257827621181583464541615625686666 
>>> N(16666.1，66) 
16666.166666666686636379788676917129516661562568666666686866686666 


由 于 浮 点 数 的 精度 有 限 ， 因 此 使 用 它 创建 Real 对 象 时 ， 即 使 指定 精度 参数 也 不 能 缩小 它 
与 理想 值 之 间 的 误差 ， 这 时 我 们 可 以 使 用 字符 串 表 示 数 值 : 


>>> N(Real(8.1,68),68) # 用 浮 点 数 创建 Real 对 象 时 ， 精 度 和 浮 点 数 相同 
6.166666666666666665551115123125782762118158346454161562566668 
>>> N(Real("6.1",68),69) # 用 字符 串 创建 Real 对 象 时 ， 所 指定 的 精度 有 效 
8.1 
>>> N(Real("6.1",66),65) # 提 高 表示 精度 ， 就 会 发 现 它 也 不 是 完全 精确 的 
@.899999999999999999999999999999999999999999999999999999999999996111 


4.2.3 ”运算 符 和 函数 


Sympy 重新 定义 了 所 有 的 数学 运算 符 和 数学 函数 。 例 如 : Add 类 表示 加 法 ，Mul 类 表示 乘 
法 ，Pow 类 表示 指数 运算 ，sin 类 表示 正弦 函数 。 和 Symbol 对 象 一 样 ， 这 些 运 算 符 和 函数 都 从 
Basic 类 继承 ,请 读者 自行 在 了 Python 中 查看 它们 的 继承 列表 (例如 Addmro0)。 可 以 使 用 这 些 类 
创建 复杂 的 表达 式 : 


>>> var("x,y,z,n") 

>>> Add(x,y,z) 

x+y+z 

>>> Add(Mul(x,y,z), Pow(x,y), sin(z)) 
x*y*z + Sin(z) + x**y 


由 于 在 Basic 类 中 重新 定义 了 _add 0 等 用 于 创建 表达 式 的 方法 ,因此 可 以 使 用 和 Python 
表达 式 相 同 的 方式 创建 SymPy 的 表达 式 : 


SY WY SINn(Z) 二 Xesy 
Xx*y*z + Sin(z) + x**y 


Basic 类 中 定义 了 两 个 很 重要 的 属性 : ftnc 和 args。func 属性 得 到 对 象 的 类 ， 而 args 得 到 


其 参数 。 使 用 这 两 个 属性 可 以 观察 SymPy 所 创建 的 表达 式 。 也 许 读者 会 对 没有 减法 运算 类 感 
到 奇怪 ， 下 面 让 我 们 看 看 减法 运算 所 得 到 的 表达 式 : 


>>> texX=Yy 

>>> t.func # 减法 运算 用 加 法 类 Add 表示 
<class “sympy.core.add.Add '> 

>>> t.args # 两 个 加 数 一 个 是 x， 一 个 是 -y 
(x, -y) 

>>> t.args[1] .func # -y 是 用 Mul 表示 的 
<class “Sympy.core.mul.Mul > 

>>> t.args[1].args 

(-1, y) 


通过 上 面 的 例子 可 以 看 出 ,表达 式 “x-y” 在 SymPy 中 实际 上 是 用 “Add(x, Mul(-1, y))” 表 
示 的 。 同 样 ，Sympy 中 没有 除法 类 ， 请 读者 使 用 和 上 面相 同 的 方法 观察 “x/y” 在 SymPy 中 是 
如 何 表示 的 。 

SympPy 的 表达 式 实际 上 是 一 个 由 Basic 类 的 各 种 对 象 进行 多 层 嵌 套 所 得 到 的 树 状 结构 。 下 
面 的 函数 使 用 递归 显示 这 种 树 状 结构 : 


fC Print expression py 
汪 显示 Sympy 的 表达 式 


def print_expression(e, level=0): 
Spaces = " "*level 
if isinstance(e, (Symbol, Number)): 
print spaces + str(e) 
return 
if len(e.args) > @: 
print spaces + e.func._name__ 
for arg in e.args: 
print_expression(arg, level+1) 
else: 
print spaces + e.func._name_ 


例如 Vx?+y? 在 SymPy 中 使 用 下 面 的 树 表示 : 
>>> print_expression(sqrt(x**2+y**2)) 
Pow 


Add 
Pow 


1/2 
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创建 自 定义 的 数学 函数 : 


>>> f = Function("f") 


请 注意 Function 虽然 是 一 个 类 , 但 是 上 面 的 语句 所 得 到 的 f 并 不 是 Function 类 的 实例 。 和 
预定 义 的 数学 函数 一 样 ，f 是 一 个 类 ， 它 从 Function 类 继承 : 


>>> f. base 

Function 

>>> isinstance(f，Function) 
False 


在 Python 中 ， 类 型 (类 ) 也 是 对 象 ， 通 常 类 型 对 象 的 类 型 是 type 对 象 ， 通 过 type0 可 以 获得 


对 象 的 类 型 ， 因 此 : 


>>> type([1,2,3]) # 列表 对 象 的 类 型 是 列表 
<type “1ist "> 

>>> type(1ist) # 列表 类 型 的 类 型 是 type 
<type 'type'> 


但 是 通过 Function 创建 的 类 型 对 象 f 的 类 型 并 不 是 type: 


>>> type(f) 
<class 'sympy.core.function.FunctionClass'> 


当 使 用 上 创建 一 个 表达 式 时 ， 就 相当 于 创建 它 的 一 个 实例 : 


>>> t = f(x,y) 
>>> type(t) 

;2 

>>> 七 .func 

2 

>>> t.args 

(x, y) 


f 的 实例 t 可 以 参与 表达 式 运算 : 


>>> t+t*t 


fy)+f (x) 


于 其 中 各 个 对 象 的 args 属性 类 型 是 元 组 ,因此 表达 式 一 旦 创建 就 不 能 再 改变 。 使 用 不 可 
变 的 结构 表示 表达 式 有 很 多 优点 ， 例 如 可 以 将 表达 式 作为 字典 的 键 。 
除了 使 用 SymPy 中 预先 定义 好 的 具有 特殊 运算 含义 的 数学 函数 之 外 , 还 可 以 使 用 Function0 


43 符号 运算 


SymPy 提供 的 符号 运算 功能 十 分 丰富 ， 然 而 由 于 篇 幅 所 限 ， 本 节 只 能 对 SymPy 中 一 些 常 
用 的 符号 运算 功能 进行 简单 的 介绍 。 


4.3.1 表达 式 变换 和 化 简 
simplify0 可 以 对 数学 表达 式 进行 化 简 ， 例 如 : 


>>> simplify((x+2)**2 - (x+1)**2) 
Fi 


simplify0 调 用 SymPy 内 部 的 多 种 表达 式 变换 函数 对 表达 式 进行 化 简 运算 。 但 是 数学 表达 
式 的 化 简 是 一 件 非常 复杂 的 工作 ， 并 且 对 于 同一 个 表达 式 ， 根 据 其 使 用 目的 可 以 有 多 种 化 简 方 
案 。 因 此 本 节 介绍 SymPy 提供 的 各 种 表达 式 变换 函数 ， 充 分 利用 这 些 函数 可 以 实现 表达 式 的 
变换 和 化 简 。 

Tadsimp0 对 表达 式 的 分 母 进行 有 理化 , 它 所 得 到 的 表达 式 的 分 母 部 分 将 不 含 无 理 数 。 例如: 


>>> radsimp(1/(sqrt(5)+2*sqrt(2))) 
1 
36543 V2 
它 也 可 以 对 带 符号 的 表达 式 进行 处 理 : 
>>> radsimp(1/(y*sqrt(x)+x*sqrt(y))) 


xy -DA 
-wy? 


ratsimp0 对 表达 式 中 的 分 母 进行 通 分 运算 ， 即 将 表达 式 转换 为 分 子 除 分 母 的 形式 : 
>>> ratsimp(x/(x+y)+y/(x-y)) 
Xx(x—y)+y(x+y) 
(x—y)(x+y) 


fraction0 返 回 一 个 包含 表达 式 的 分 子 和 分 母 的 元 组 ， 用 它 可 以 获得 ratsimp0 通 分 之 后 的 分 
子 或 分 母 ; 


>>> fraction(ratsimp(1/x+1/y)) 
(x + y, x*y) 


请 注意 fraction0 不 会 自动 对 表达 式 进 行 通 分 运算 ， 因 此 : 
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>>> fraction(1/x+1/y) 
(1/x + 1/y, 1) 


cancel0 和 trimQ 对 分 式 表达 式 的 分 子 分 母 进行 约 分 运算 ， 去 除 它们 的 公 因 式 。cancel0 只 能 
对 纯 符 号 的 分 式 表达 式 进行 约 分 ， 而 tim0 则 可 以 对 表达 式 中 的 任意 部 分 进行 约 分 ， 并 且 支 持 函 
数 表达 式 的 约 分 运算 : 


>>> cancel((x**2-1)/(1+x)) 

-1 + X 

>>> cancel(sin((x**2-1)/(1+x))) # cancel 不 能 对 函数 内 部 的 表达 式 进行 约 分 
sin((x**2-1)/(1+x)) 

>>> trim(sin((x**2-1)/(1+X))) # trim 可 以 对 内 部 表达 式 进行 约 分 

-sin(1 - x) 

>>> cancel((f(x)**2-1)/(f(x)+1)) # cancel 不 能 对 带 函 数 的 表达 式 进行 约 分 
(F(x)**2-1)/ (f(x)+1) 

>>> trim( (f(x)**2-1)/(f(x)+1)) # trim 可 以 对 带 函数 的 表达 式 进行 约 分 

-1 + f(x) 


trigsimp0 对 表达 式 中 的 三 角 函 数 进行 化 简 。 它 有 两 个 可 选 参 数 一 deep 和 recursive， 默 认 
值 都 为 False。 当 deep 参数 为 True 时 , 将 对 表达 式 中 的 所 有 子 表 达 式 进行 简化 运算 ; 当 recursive 
参数 为 True 时 ， 将 递归 使 用 trigsimp0 进 行 最 大 限度 的 化 简 : 


>>> trigsimp(sin(x)**2+2*sin(x)*cos(x)+cos(x)**2) 

1 + 2*cos(x)*sin(x) 

>>> trigsimp(f(sin(x)**2+2*sin(x)*cos(x)+cos(x)**2)) # 对 于 嵌 套 的 表达 式 不 进行 简化 
f(2*cos(x)*sin(x) + Cos(x)**2 + sin (x)**2) 

>>> trigsimp(f(sin(x)**2+2*sin(x)*cos(x)+cos(x)**2)，,deep=True) # 对 风 套 表达 式 进 行 处 理 
f(1 + 2*cos(x)*sin(x)) 


请 注意 , 虽然 2 cos x sin x 还 可 以 再 简化 为 sin 2x , 但 是 目前 tigsimp0 对 这 种 简化 无 能 为 力 。 

expand trig0 可 以 对 三 角 函 数 的 表达 式 进行 展开 。 它 实际 上 是 对 expand0 的 封装 ， 通 过 将 
expand0 的 tig 参数 设置 为 True, 实现 三 角 函 数 的 展开 计算 ,读者 可 以 在 IPython 下 输入 “expand tig??” 
来 查看 它 调用 expandO 时 的 参数 。 

>>> expand trig(sin(2*x+y)) 


—sin(y)+2cos’(x)sin( y)+2cos(x)cos(y)sin(x) 


expand0 根 据 用 户 设 置 的 标志 参数 对 表达 式 进行 展开 。 默 认 情况 下 ， 以 下 的 标志 参数 为 
True。 


mul: 展开 乘法 


>>> expand(x*(y+z)) 


WY 于 证 
log: 展开 对 数 函数 参数 中 的 乘积 和 圭 运 算 


>>> x,y=symbols("x,y",positive=True) 
>>> expand(log(x*y**2)) 
2*1og(y) + log(x) 


multinomial: 展开 加 法 式 的 整数 次 震 


>>> expand((x+y)*#*3) 
Ep pt es et tt 居 汪 玫 生 学 攻 3 


power base: 展开 窜 函 数 的 底数 乘积 


>>> expand( (x*y)**z) 
XZ 六 六 不 


power_exp: 展开 窜 函 数 的 指数 和 


>>> expand(x**(y+z)) 
X**Yy*X**Z 


可 以 将 默认 为 True 的 标志 参数 设置 为 False, 强制 不 展开 对 应 的 表达 式 。 在 下 面 的 例子 中 ， 
将 mul 设置 为 False， 因 此 不 对 乘法 进行 展开 : 


>>> x,y,z=symbols("x,y,z", positive=True) 
>>> expand(x*log(y*z), mul=False) 
x*(log(y) + log(z)) 
expand0 的 以 下 标志 参数 默认 为 False。 
complex: 展开 复数 的 实 部 和 虚 部 

>>> x,y=symbols("x,y",complex=True) 


>>> expand(x*y, complex=True) 
re(x)*re(y) - im(x)*im(y) + I*im(x)*re(y) + I*im(y)*re(x) 


func: 对 一 些 特殊 函数 进行 展开 


>>> expand(gamma(1+x),func=True) 
x*gamma(x) 


trig: 展开 三 角 函 数 


>>> expand(sin(x+y), trig=True) 
cos(x)*sin(y) + cos(y)*sin(x) 
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expand log0、expand_ mul0、expand_complex0、expand trig0、expand_ func0 等 函数 则 通 
过 将 相应 的 标志 参数 设置 为 True， 对 expand0 进 行 封装 。 
和 actor0 可 以 对 多 项 式 表达 式 进行 因 式 分 解 : 


>>> factor(15*x**2+2*y-3*x-10*x*y) 
(1 - S*x)*(-3*x + 2*y) 

>>> factor(expand( (x+y)**20)) 
(x+y)**20 


collect0 收 集 表达 式 中 指定 符号 的 有 理 指数 次 军 的 系数 。 例 如 ， 我 们 希望 获得 如 下 表达 式 
中 x 的 各 次 窜 的 系数 : 


>>> eq = (1l+a*x)**3 + (1+b*x)**2 
首先 需要 对 表达 式 eq 进行 展开 ， 得 到 的 表达 式 eq2 是 一 系列 乘 式 的 和 : 


>>> eq2 = expand(eq) 
>>> eq2 


2+2bx +3ax+Dbix +3ax? 十 Q3ax3 
然后 调用 collect0， 对 表达 式 eq2 中 x 的 客 的 系数 进行 收集 : 
>>> collect(eq2, x) 
2+x(2b+3a)+x’ (b+3a’)+a x’ 


默认 情况 下 , collect0 返 回 的 是 一 个 整理 之 后 的 表达 式 , 如 果 我 们 希望 得 到 x 的 各 次 守 的 系 
数 ， 可 以 设置 evaluate 参数 为 False， 让 它 返 回 一 个 以 x 的 曙 为 键 、 值 为 系数 的 字典 : 


>>> p = collect(eq2, x, evaluate=False) 

>>> p[S(1)] # 常数 项 ， 注 意 需 要 用 SymPy 中 的 数值 1， 或 者 使 用 p[x**8] 
加 

>>> p[x**2] # x 的 2 次 项 系数 


b**2 + 3*a**2 
collect0 也 可 以 收集 表达 式 的 各 次 宫 的 系数 , 例如 下 面 的 程序 收集 表达 式 “sin(2*x)” 的 系数 : 


>>> collect(a*sin(2*x) + b*sin(2*x), sin(2*x)) 
(a + b)*sin(2*x) 


4.3.2 方程 


在 SymPy 中 ,表达 式 可 以 直接 表示 值 为 0 的 方程 。 也 可 以 使 用 Eq0 创 建 方程 。 solve0 可 以 
对 方程 进行 符号 求解 ， 它 的 第 一 个 参数 是 表示 方程 的 表达 式 ， 其 后 的 参数 是 表示 方程 中 未 知 变 


量 的 符号 。 下 面 的 例子 使 用 solve0 对 一 元 二 次 方程 进行 求解 : 


>>> a,b,c = symbols("a,b,c") 
>>> solve(a*x**2+b*x+C, xX) 


_b+y-4ac+b’ b+V-4ac+p? 
2a ” 2a 


由 于 方程 的 解 可 能 有 多 组 ， 因 此 solve0 返 回 一 个 列表 保存 所 有 的 解 。 可 以 传递 包含 多 个 表 
达 式 的 元 组 或 列表 ， 让 solve0 对 方程 组 进行 求解 ， 得 到 的 解 是 两 层 嵌 套 的 列表 ， 其 中 每 个 元 组 
表示 方程 组 的 一 组 解 : 


>>> solve((x**2+x*y+1,y**2+X*y+2),X,y) 
[535 CI)| 


4.3.3 微分 


Derivative 是 表示 导 函 数 的 类 ， 它 的 第 一 个 参数 是 需要 进行 求 导 的 数学 函数 ， 第 二 个 参数 
是 求 导 的 自 变量 。 请 注意 Derivative 所 得 到 的 是 一 个 导 函 数 ， 它 并 不 会 进行 求 导 运 算 : 


>>> 七 = Derivative(sin(x), x) 
>>> 七 
D(sin(x), x) 


如 果 希 望 它 进行 实际 的 运算 ， 计 算出 导 函 数 ， 可 以 调用 其 doit0 方 法 : 


>>> t.doit() 
cos(x) 


也 可 以 直接 使 用 diff0 函 数 或 表达 式 的 diff0) 方 法 来 计算 导 函 数 : 


>>> diff(sin(2*x), x) 
2*cos(2*x) 
>>> sin(2*x).diff(x) 
2*cos(2*x) 


使 用 Derivative 对 象 可 以 表示 我 们 自 定义 的 数学 函数 的 导 函 数 ， 例 如 : 


>>> Derivative(f(x), x) 
DCf(x)，x) 


由 于 SymPy 不 知道 如 何 对 自 定义 的 数学 函数 进行 求 导 ， 因 此 它 的 diff0 方 法 会 返回 和 上 面 
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相同 的 结果 : 


>>> f(x).diff(x) 
D(F(x), x) 


添加 更 多 的 符号 参数 可 以 表示 高 阶 导 函数 ， 例 如 : 
>>> Derivative(f(x)，x，x，x) # 也 可 以 写作 Derivative(f(x)，x，3) 
7 G9 
也 可 以 表示 多 个 变量 的 导 函 数 ， 例 如 : 
>>> Derivative(f(x,y), x,2,y,3) 
5 
62x637 
diff0 的 参数 和 Derivative 相同 ， 例 如 下 面 的 语句 计算 sin(xy) 对 x 两 次 求 导 、 对 ? 三 次 求 导 
的 结果 : 


f(x,y) 


>>> diff(sin(x*y), x,2,y,3) 


—6xcos(xy) + x y? cos(xy) + 6yx? sin(xy) 
4.3.4 ”微分 方程 


dsolve0 可 以 对 微分 方程 进行 符号 求解 。 它 的 第 一 个 参数 是 一 个 带 未 知 函 数 的 表达 式 ， 第 
二 个 参数 是 需要 进行 求解 的 未 知 函 数 。 例 如 下 面 的 程序 对 微分 方程 1'(x) -了 (x) = 0 进行 求解 。 
得 到 的 结果 是 一 个 自然 指数 函数 ， 它 有 一 个 待定 系数 c, 。 


>>> f=Function("f") 
>>> dsolve(Derivative(f(x),x) - f(x), f(x)) 


f(W=e” 


用 dsolve0 解 微分 方程 时 可 以 传递 一 个 hint 参数 ， 指 定 微分 方程 的 解法 。 该 参数 的 默认 值 
为 "default"， 表 示 由 SymPy 自动 挑选 解法 。 可 以 将 hint 参数 设置 为 "best"， 让 dsolve0 尝 试 所 有 


已 知 解法 ， 并 返回 最 简单 的 解 ， 例 如 下 面 对 微 分 方程 2 f(x) + /CD + ?GO = 0 进行 求解 。 得 
到 的 结果 是 一 个 一 般 方程 ， 它 描述 了 to 和 自 变量 之 问 的 关系 。 一 般 把 这 种 函数 称 为 隐 函 数 : 


>>> x = symbols("x"，real=True) # 定义 符号 x 为 实数 
>>> eql = dsolve(f(x).diff(x) + f(x)**2 + f(x), f(x)) 


>>> eql 
-log(1 + f(x)) + log(f(x)) = C1 - x 


如 果 设 置 hint 参数 为 "best"， 就 能 得 到 更 简单 的 显 函 数 表达 式 : 


>>> eq2 = dsolve(f(x).diff(x) + f(x)**2 + f(x), f(x), hint="best") 
>>> eq2 


3 
二 


CO 一 e 


下 面 让 我 们 用 程序 验证 一 下 上 面 的 两 个 结果 是 等 价 的 。eql 和 eq2 是 两 个 表示 等 式 的 
Equality 对 象 ， 等 号 左右 两 边 的 表达 式 可 以 通过 其 lhs 和 ths 属性 获得 : 


Jo = 


>>> eq1.func 

<class “sympy.core.relational.Equality > 
>>> eq1.1lhs 

-log(1 + f(x)) + log(f(x)) 

>>> eql.rhs 

Ci=-Xx 


为 了 验证 eql 和 eq2 两 个 等 式 是 等 价 的 ， 只 需要 将 eq2 代入 到 eql 中 进行 化 简 即 可 。 这 个 
替换 工作 可 以 由 subs0 完 成 ， 将 subs0 得 到 的 结果 经 由 simplify0 进 行 化 简 : 


>>> simplify(eq1.1hs.subs({f(x):eq2.rhs})) 
-x - log(C1) 


可 以 看 到 除了 常数 项 之 外 ， 上 面 的 结果 和 eql 的 右 式 是 一 样 的 。 
4.3.5 积分 


integrate() 可 以 计算 定 积分 和 不 定 积分 : 
。 integrate(f, x): 计算 不 定 积分 | 三 


® integrate(f (x,a,b)): 计算 定 积分 | Jar 


如 果 要 对 多 个 变量 计算 多 重 积 分 ， 只 需要 将 被 积分 的 变量 依次 列 出 即 可 : 
。 integrate(f x, y): 计算 双重 不 定 积分 | /we 


。 integrate(f cab ed)): 计算 双重 定 积分 | au 


和 Derivative 对 象 表示 微分 表达 式 类 似 , Integral 对 象 表示 积分 表达 式 , 它 的 参数 和 integrate0 
类 似 ， 例 如 : 
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>>> e = Integral(x*sin(x), x) 
>>> e 


| xsin(x)dx 


调用 积分 对 象 的 doit0 方 法 可 以 对 其 进行 求 值 计算 : 


>>> e.doit() 
-x*cos(x) + sin(x) 


有 些 积分 表达 式 无 法 进行 符号 化 简 ， 这 时 可 以 调用 其 evalf0 方 法 或 用 求 值 函 数 NO 对 其 进 
行 数值 运算 : 


>>> e2 = Integral(sin(x)/x, (x, 8, 1)) 
>>> e2.doit() 


/Os 


o 开 


由 于 无 法 进行 符号 定 积分 ， 因 此 doit0 返 回 积分 表达 式 本 身 。 下 面 我 们 用 evalf0 和 NO 对 其 
进行 数值 运算 : 


>>> e2.evalf() 

8@.946883878367183 

>>> N(e2) 

8@.946883876367183 

>>> N(e2，166) # 可 以 指定 精度 
@.946883876367183861494135331382317965781233795473811 


实际 上 SC9 的 积分 被 定义 为 一 个 特殊 函数 ， 它 从 0 到 无 穷 的 定 积分 为 /2 ， 即 : 
b 4 


[a= 
1 EE 3 


SympPy 的 数值 计算 功能 还 不 够 强大 ， 不 能 对 应 如 下 这 种 情况 的 无 限 积分 : 


>>> N(Integral(sin(x)/x，(x，8，00))) # oo 表示 正 无 穷 
.9e+6 


将 积分 上 限 修改 为 10000 也 没 能 计算 出 近似 结果 ， 上 限 为 1000 时 得 到 了 /2 的 近似 值 ， 
不 过 还 远 远 不 够 精确 : 


>>> N(Integral(sin(x)/x，(x，68，16666) )) 
-e+ 
>>>N(Integral(sin(x)/x，(x，68，1666))) 
1.57823312196877 


as_sum() 方 法 可 以 将 定 积分 转换 为 近似 求 和 公式 ， 它 将 积分 区 域 分 割 成 N 个 小 矩形 的 面积 
之 和 : 


>>> Integral(sin(x), (x, 8, 1)).as_sum(5) 


| mE “SW I Se Sy ey Fe 
SA TA TA A 
44 其 他 功能 


4.4.1 平面 几何 


使 用 SymPy 的 geometry 模块 可 以 创建 表示 二 维 几何 图 形 的 对 象 , 例如 直线 、 线段 、 圆 等 ， 
并 计算 这 些 对 象 的 各 种 信息 。 例 如 计算 椭圆 的 面积 ， 判 断 一 组 点 是 否 共 线 ， 或 者 求 两 条 直线 的 
交点 。 下 面 我 们 通过 一 个 例子 介绍 geometry 模块 的 基本 用 法 。 

如 图 4-1 所 示 ，D 是 三 角形 ABC 的 内 切 圆 圆心 ， 过 C、D、B 三 点 的 圆 与 直线 AB 和 AC 
分 别 交 于 F 和 G 两 点 。 线 段 1 和 j 是 交点 构成 的 弦 , 可 以 证 明 它 们 的 长 度 是 相等 的 。 用 geometry 
模块 无 法 帮助 我 们 证 明 这 个 命题 ， 但 是 可 以 通过 计算 线段 1 和 j 的 长 度 对 其 进行 验证 。 


4-1 弦 相 等 几何 题 示意 图 


i sympy_geometry.py 
验证 弦 相 等 


geometry 模块 用 解析 几何 的 形式 表示 几何 实体 ， 因 此 需要 用 坐标 表示 点 的 位 置 。 虽 然 三 角 
形 的 顶点 的 位 置 是 任意 的 ， 但 是 我 们 可 以 让 点 A 处 于 原点 、 点 B 在 和 X 轴 上 、 点 C 在 立轴 的 上 
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方 ， 例 如 : 


>>> A = Point(8,6) 
>>> B = Point(5,6) 
>>> C = Point(3,2) 


Point 对 象 表示 坐标 点 。 其 中 的 5、3、2 等 数值 可 以 换 成 任意 其 他 的 值 ， 只 要 A、B、C 三 
点 不 共 线 ， 能 构成 三 角形 即 可 。 下 面 创建 以 这 三 个 点 为 顶点 的 三 角形 t: 


>>> t = Triangle(A,B,C) 
Triangle 对 象 表示 三 角形 。 三 角形 的 内 切 圆 圆 心 可 以 通过 其 incenter 属性 获得 : 


>>> D =t.incenter 
>>> D 


140-30V2 -10V26+40V13 50-20V2 +10V13 
30+10V13 ” 30+10V13 


虽然 三 角形 的 顶点 坐标 是 整数 ， 但 是 它 的 内 切 圆 圆心 的 坐标 却 很 复杂 。 目 前 geometry 模 
块 "只 能 对 精确 数值 进行 计算 ， 无 法 使 用 浮 点 数 。 因 此 当 几 何 图 形 十 分 复杂 时 ， 计 算 量 将 非常 
大 ， 和 希望 它 以 后 能 支持 浮 点 数 ， 进 行 更 复杂 的 几何 运算 。 

Circle 对 象 表示 圆 。 可 以 通过 指定 圆心 坐标 、 半 径 ， 或 者 圆 上 的 三 个 点 来 创建 。 这 里 用 C、 
D、B 三 点 创建 圆 p: 


>>> p = Circle(C,D,B) 
圆 和 直线 的 交点 可 以 通过 圆 的 intersection0 方 法 计算 : 


>>> i = Segment(*p.intersection(Line(A,B))) 
>>> j = Segment(*p.intersection(Line(A,C))) 


这 里 的 Line(A,B) 和 Line(A,C) 是 临时 创建 的 直线 对 象 。 由 于 圆 和 直线 有 两 个 交点 ， 因 此 
intersection() 方 法 返回 的 是 一 个 有 两 个 Point 对 象 的 列表 。 通 过 这 两 个 交点 创建 表示 弦 线 段 的 
Segment 对 象 。 

接 下 来 通过 Segment 对 象 的 length 属性 查看 其 长 度 。 注意 length 属性 是 一 个 表示 精确 值 的 
表达 式 ， 它 非常 复杂 ， 因 此 我 们 调用 它 的 evalft0 查 看 其 近似 的 浮 点 值 : 


>>> i.length.evalf(56) 
1.3944487245366167668867787325295648537487634261548 
>>> Jj.length.evalf(56) 
1 .39444872453661676688677873252956468537487834261548 


@ 本 书写 作 时 SymPy 的 版 本 号 为 0.6.7。 


4.4.2 绘图 


用 Plot0 可 以 快速 绘制 二 维 函 数 曲 线 或 三 维 函数 曲面 。 


如 果 调 用 绘图 函数 时 出 现 “Window initialization failed” 错 误 ,请 按照 下 面 的 说 明 进 行 
修改 。 


为 操作 系统 添加 一 个 环境 变量 :“PYGLET_SHADOW_WINDOW=0”。 或 者 在 程序 开头 
添加 下 面 的 代码 ， 为 程序 的 运行 环境 临时 添加 环境 变量 : 


import os 
os.environ['PYGLET_SHADOW_WINDOW' ]="@" 


g A sympy_plot2d.py 
全 于 用 Sympy 绘制 二 维 函数 曲线 


Plot0 的 参数 十 分 灵活 ， 我 们 直接 通过 实例 进行 讲解 。 在 了 Python 交互 环境 下 运行 绘图 代码 
之 前 ， 请 先 运行 上 面 的 代码 以 添加 环境 变量 。 


>>> p = Plot(x/2) 


将 弹出 一 个 名 为 “SymPy Plot” 的 绘图 窗口 ， 并 绘制 一 条 方程 为 y=x/2 的 直线 。Plot0 返 
回 的 是 一 个 Plot 对 象 : 


>>> type(p) 
<class 'sympy.plotting.plot.Plot'> 


Plot 对 象 可 以 当做 列表 使 用 ， 其 中 的 每 个 元 素 都 表示 图 表 中 的 一 个 绘图 实体 ， 由 于 前 面 只 
绘制 了 一 条 曲线 ， 因 此 对 象 p 的 长 度 为 1， 图 中 的 曲线 与 一 个 Cartesian2D 对 象 对 应 。 


>>> len(p) 

下 

>>> p[8] # 图 中 的 曲线 

x/2, [x,-5,5,100], 'mode=cartesian; color=rainbow; style=solid' 
>>> type(p[8]) # 曲线 是 一 个 Cartesian2D 对 象 

<class 'sympy.plotting.plot_modes.Cartesian2D'> 

>>> p # 直接 查看 图 表 中 的 元 素 列表 


[8]: x/2,'mode=cartesian" 


请 注意 曲线 表达 式 和 符号 名 没有 关系 , 它 只 和 符号 的 个 数 有 关 , 表达 式 中 只 有 一 个 符号 时 ， 
将 绘制 二 维 曲 线 。 下 面 再 添加 几 条 曲线 ， 直 接 调 用 append0 将 曲线 所 对 应 的 函数 表达 式 添加 进 
绘图 对 象 即 可 : 


吊 卉 区 熔 志 业 汶 一 人 duwAS 


1135 


吊 提 消 疮 所 员 二 -一 人 duwAS 


136 | 


Python 科学 计算 


>>> p.append(x**2) 

>>> p.append(log(x)) 

>>> p 

[8]: x/2， "mode=cartesian' 
[1]: x**2, "mode=cartesian" 
[2]: log(x), ‘mode=cartesian’ 


当 传 递 两 个 带 同一 符号 的 表达 式 给 Plot0 时 ， 将 绘制 二 维 参数 曲线 : 
>>> p.append(sin(x)，cos(x)) # 添加 一 个 圆 
>>> p[3] 


sin(x), cos(x), "mode=parametric 


也 可 以 通过 参数 指定 在 极 坐 标 系 中 绘图 , 请 注意 所 有 的 参数 是 通过 一 个 分 号 隔 开 的 字符 串 
表示 ， 而 不 是 通过 函数 的 关键 字 参 数 传递 。 在 下 面 的 例子 中 ， 设 置 "mode" 绘 图 参数 为 "polar"， 
因此 将 在 极 坐 标 中 绘制 函数 > = cos(26) : 


>>> p.append(cos(2*x)，"mode=polar") 


Plot 对 象 的 axes 属性 是 表示 坐标 轴 的 PlotAxes 对 象 ， 通 过 设置 它 的 属性 可 以 改变 坐标 轴 
的 一 些 显示 效果 ， 例 如 下 面 的 语句 显示 坐标 轴 上 的 刻度 的 数值 : 


>>> p.axes._label axes = True 
最 后 调用 p.saveimage0 将 图 表 保 存 成 图 像 文件 ， 结 果 如 图 4-2 所 示 ( 见 文 前 彩 插 )。 


>>> p.saveimage("sympy_plot2d.png") 


个 显示 刻度 值 会 极 大 影响 图 表 的 绘制 速度 ， 因 此 建议 只 在 保存 图 像 时 显示 刻度 线 。 


4-2 使 用 SymPy 绘制 的 函数 曲线 


Plot0 还 可 以 在 三 维 空间 中 绘图 ， 下 面 列 出 SympPy 支持 的 三 维 绘图 模式 : 
e， 双 变量 表达 式 ， 当 "mode" 参 数 默认 时 ， 在 直角 坐标 系 中 绘制 曲面 ， 默认 自 变量 名 为 x 
和 y。 
。 双 变 量 表达 式 ，"mode=cylindrical"， 在 圆柱 坐标 系 中 绘制 曲面 ， 默 认 自 变量 名 为 t 
和 he。 
。 双 变 量 表 达 式 ，"mode=spherical"， 在 球 坐标 系 中 绘制 曲面 ， 默 认 自 变量 名 为 t+ 和 p。 
。 三 个 单 变量 表达 式 ， 绘 制 三 维 空间 中 的 参数 曲线 ， 默 认 自 变量 名 为 t。 
。 三 个 双 变量 表达 式 ， 绘 制 三 维 空间 中 的 参数 曲面 ， 默 认 自 变量 名 为 u 和 v。 
由 于 三 维 空间 中 的 曲面 需要 两 个 变量 才能 确定 ,为 了 不 混淆 变量 含义 ， 建 议 使 用 默认 的 自 
变量 名 创建 表达 式 ， 或 者 通过 指定 自 变量 范围 来 明确 每 个 变量 的 含义 。 例 如 在 圆柱 坐标 系 中 ， 
变量 t 表示 高 度 ，h 表示 角度 ， 而 表达 式 计算 的 值 是 半径 。 当 表达 式 中 缺少 自 变量 时 ， 通 过 指 
定 自 变量 范围 可 以 明确 指定 其 含义 。 第 一 个 指定 范围 的 自 变量 为 角度 ， 第 二 个 为 高 度 。 
例如 ， 下 面 在 圆柱 坐标 系 中 绘制 一 个 乙 轴 方 向 的 正弦 波 绕 Z 轴 旋 转 180” 所 得 的 旋转 面 ， 
效果 如 图 4-3( 左 ) 所 示 ( 见 文 前 彩 插 )。 


>>> t, h = Symbols("t,h") 
>>> Plot(sin(t)+2, [h,8,pil],[t,8,2*pi], "mode=cylindrical") 


由 于 表达 式 中 缺少 变量 h, 因此 通过 第 二 个 参数 指定 旋转 角度 变量 h 的 范围 为 0" 到 180* 。 
而 Z 轴 方 向 正弦 波 的 变量 范围 是 0° 到 360” 。 

最 后 看 一 个 用 参数 曲面 绘制 麦 比 乌 斯 带 的 例子 ， 效 果 如 图 4-3( 右 ) 所 示 ( 见 文 前 彩 插 )。 

用 一 个 纸 带 旋转 半 圈 再 把 两 端 类 上 之 后 所 形成 的 曲面 只 有 一 个 表面 和 一 个 边界 , 这 种 曲面 
称 为 麦 比 乌 斯 带 。 它 可 以 用 如 下 参数 方程 描述 : 


x(u,v) = (1+3veosdu Jeosw 
2 

y(u. -1+3veosdu jsinn 

a 2 到 


| 
z(u,v) = 二 vsin 一 
(u,v) Fi 5 


其 中 变量 u 的 取 值 范围 是 0 到 2z ， 变 量 v 的 取 值 范围 是 -1 到 1。 下 面 是 完整 的 源 程序 。 
当 传递 三 个 双 变量 表达 式 时 ，Plot0 将 绘制 参数 曲面 。 


a sympy_mobius.py 
用 参数 曲面 绘制 麦 比 乌 斯 带 


from sympy import * 
u, Vv = symbols("u,v") 
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X = (14V/2*cos(u/2))*cos(u) 
y = (1+v/2*cos(u/2))*sin(u) 
z = v/2*sin(u/2) 


Plot Oo yz Lu ;S21pil] TV 


图 4-3 圆柱 坐标 系 中 的 旋转 曲面 ( 左 )、 用 参数 曲面 绘制 麦 比 乌 斯 带 ( 右 ) 


控制 绘图 窗口 

在 绘图 窗口 中 可 以 使 用 快捷 键 或 鼠标 对 三 维 场景 进行 操作 : 

e 缩放 : 按 住 Page Up 和 Page Down 键 ， 使 用 鼠标 滑轮 滚动 ， 或 者 用 鼠标 中 键 进 行 上 下 
拖 动 。 

。 平移 ; 按 住 鼠 标 右键 并 拖 动 。 

e 旋转 : 按键 A 和 D、S 和 W、Q 和 E, 或 者 用 鼠标 左 键 拖 动 。 

。 上 默认 视图 方向 : 按键 F1 看 XY 平面 ,按键 fF2 看 XZ 平面 , 按键 F3 看 YZ 平面 , 按键 
F4 看 透视 图 。 

e 坐标 轴 : 按键 F5 切换 显示 ， 按 键 F6 切换 颜色 。 

。 保存 图 像 : 按键 F8 将 当前 场景 保存 成 PNG 图 像 。 

。 按 住 Shift 键 可 以 进行 高 精度 缩放 、 平 移 和 旋转 操作 。 


| 
| 
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matplotlib 一 一 绘制 精美 的 图 表 


matplotlib 是 Python 最 著名 的 绘图 库 ， 它 提供 了 一 整套 和 MATLAB 类 似 的 绘图 函数 集 ， 
十 分 适合 编写 短小 的 脚本 程序 ， 进 行 快速 绘图 。 此 外 ，matplotlib 采用 面向 对 象 技术 来 实现 ， 因 
此 组 成 图 表 的 各 个 元 素 都 是 对 象 , 在 编写 较 大 的 应 用 程序 时 通过 面向 对 象 的 方式 使 用 matplotlib 
将 更 加 有 效 。 

matplotlib 的 文档 十 分 完备 ， 并 且 展 示 页 面 中 有 上 百 幅 图 表 的 缩 略 图 及 源 程序 。 因 此 如 果 
读者 需要 绘制 某 种 类 型 的 图 表 ， 只 需要 在 这 个 页 面 中 “浏览 /复制 /粘贴 ”一 下 ， 基 本 上 就 都 能 
快速 解决 。 


© http://matplotlib.sourceforge.net/gallery.html 
matplotlib 展示 页 面 的 地 址 


本 章 在 简单 介绍 matplotlib 的 快速 绘图 功能 之 后 ， 将 较为 深入 地 分 析 几 个 实例 ， 让 读者 从 
中 学 习 和 理解 matplotlib 绘图 的 一 些 基本 概念 。 相 信 读 者 在 了 解 本 章 的 内 容 之 后 ， 应 该 能 够 根 
据 官方 文档 和 演示 程序 使 用 matplotlib 完美 地 展示 自己 的 数据 。 


5.1 快速 绘图 


5.1.1 使 用 pyplot 模块 绘图 


matplotlib 的 pyplot 模块 提供 了 和 MATLAB 类 似 的 绘图 API, 可 方便 用 户 快速 绘制 二 维 图 
表 。 我 们 先 看 一 个 简单 的 例子 : 


sh matplotlib_simple_plot.py 
使 用 pyplot 模块 快速 绘图 


import numpy as np 

import matplotlib.pyplot as plt © 
x = np.linspace(0, 10, 10600) 

y = np.sin(x) 


z = Np.cos(x**2) 


，Python 科学 计算 
| plt.figure(figsize=(8,4)) ©@ 

| plt.plot(x,y,1abel="$sin(x)$",color="red",linewidth=2) © 
plt.plot(x,z,"b--",1label="$cos(x^2)$") @ 
plt.xlabel("Time(s)") © 

| plt.ylabel("Volt") 

plt.title("PyPlot First Example") 


plt.ylim(-1.2,1.2) 
plt.legend() 


plt.show() © 


程序 的 输出 如 图 5-1 所 示 。 


[TIE Ce) 
,今日 日 十 而 加 < 一 保存 按钮 图 示 
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5-1 使 用 pyplot 模块 快速 将 数据 绘制 成 曲线 图 


@ 首 先 载 入 matplotlib 的 绘图 模块 pyplot， 并 重 命名 为 plt。 


pylab 模块 

matplotlib 提供 了 一 个 名 为 pylab 的 模块 ， 其 中 包括 了 许多 NumPy 和 pyplot 模块 中 常用 
的 函数 ， 可 以 方便 用 户 快速 进行 计算 和 绘图 ， 十 分 适合 在 IPython 交互 式 环境 中 使 用 。 本 书 
使 用 下 面 的 方式 载 入 pylab 模块 : 


>>> import pylab as pl 


@ 调 用 figure0 创 建 一 个 Figure( 图 表 ) 对 象 ， 并 且 它 将 成 为 当前 Figure 对 象 。 也 可 以 不 创建 
Figure 对 象 ， 而 是 直接 调用 接 下 来 的 plot0 进 行 绘图 ， 这 时 matplotlib 会 自动 创建 一 个 Figure 对 
象 .figsize 参数 指定 Figure 对 象 的 宽度 和 高 度 , 单位 为 英寸 .此 外 还 可 以 使 用 dpi 参数 指 定 Figure 
对 象 的 分 辨 率 ， 即 每 英寸 所 表示 的 像素 数 ， 这 里 使 用 默认 值 80。 因 此 本 例 中 创建 的 Figure 对 象 


的 宽度 为 “8X80 = 640” 个 像素 。 但 是 在 显示 出 绘图 窗口 之 后 ， 用 工具 栏 中 的 保存 按钮 将 图 表 
保存 为 图 像 时 ， 保 存 的 图 像 的 大 小 是 “800X400” 像素。 这 是 因为 保存 图 像 时 会 使 用 不 同 的 dpi 
设置 。 这 个 设置 保存 在 matplotlib 的 配置 文件 中 ， 可 以 通过 如 下 语句 查看 它 的 值 : 


>>> import matplotlib 
>>> matplotlib.rcParams["savefig.dpi"] 
166 


因为 保存 图 像 时 的 dpi 设置 为 100， 所 以 保存 的 图 像 的 宽度 是 “8X 100 = 800” 个 像素 。 
rcParams 是 一 个 字典 ， 其 中 保存 着 从 配置 文件 读 入 的 所 有 配置 ， 在 调用 各 种 绘图 函数 时 ， 这 些 
配置 将 会 作为 各 种 参数 的 默认 值 。 后 面 我 们 还 会 对 matplotlib 的 配置 文件 进行 详细 介绍 。 

目 创 建 Figure 对 象 之 后 ， 接 下 来 调用 plot0 在 当前 的 Figure 对 象 中 绘图 。 实 际 上 plot0 是 在 
Axes( 子 图 ) 对 象 上 绘图 ， 如 果 当 前 的 Figure 对 象 中 没有 Axes 对 象 ， 那 么 将 会 为 之 创建 一 个 几 
平 充满 整个 图 表 的 Axes 对 象 ， 并 使 此 Axes 对 象 成 为 当前 的 Axes 对 象 。plot0 的 前 两 个 参数 是 
分 别 表示 X、Y 轴 数 据 的 对 象 ， 这 里 使 用 的 是 NumpPy 数组 。 使 用 关键 字 参 数 可 以 指定 所 绘制 
曲线 的 各 种 属性 : 

e label: 给 曲线 指定 一 个 标签 名 称 ， 此 标签 将 在 图 示 中 显示 。 如 果 标 签字 符 串 的 前 后 有 

字符 '$'， 那 么 matplotlib 会 使 用 内 赚 的 LaTeX 引擎 将 其 显示 为 数学 公式 。 

e color: 指定 曲线 的 颜色 ， 颜 色 可 以 用 英文 单词 来 表示 ， 也 可 以 用 以 # 字 符 开头 的 三 个 

16 进 制 数 来 表示 ， 例 如 #ff0000' 表 示 红 色 。 还 可 以 使 用 值 在 0 到 1 范围 之 内 的 三 个 元 
素 的 元 组 来 表示 ， 例 如 (1.0, 0.0, 0.0) 也 表示 红色 。 
e linewidth: 指定 曲线 的 宽度 ， 可 以 不 是 整数 ， 但 可 以 使 用 缩写 形式 的 参数 名 lw。 


个 使 用 LaTex 语法 绘制 数学 公式 会 极 大 地 降低 图 表 的 描绘 速度 。 


@ 直 接 通 过 第 三 个 参数 b--' 指 定 曲线 的 颜色 和 线 型 ， 它 通过 一 些 易 记 的 符号 指定 曲线 的 样 
式 。 其 中 b 表 示 蓝 色 ，'-- 表 示 线 型 为 虚线 。 在 IPython 中 输入 “plt.plot?”， 可 以 查看 格式 化 字 
符 串 及 各 个 参数 的 详细 说 明 。 

@ 接 下 来 通过 一 系列 函数 设置 当前 Axes 对 象 的 各 个 属性 : 

e xlabel、ylabel: 分 别 设置 X、Y 轴 的 标题 文字 。 

e title: 设置 子 图 的 标题 。 

。 xlim、ylim: 分 别 设置 X、Y 轴 的 显示 范围 。 

e legend: 显示 图 示 ， 即 图 中 表示 每 条 曲线 的 标签 abeD 和 样式 的 矩形 区 域 。 

@ 最 后 调用 pltshow0 显 示 出 绘图 窗口 。 在 通常 情况 下 ，show0 将 会 阻塞 程序 的 运行 ， 直 到 
用 户 关闭 绘图 窗口 。 然 而 在 带 “-wthread ”等 参数 的 Python 环境 下 ，show0 不 会 等 待 窗口 关闭 。 

还 可 以 调用 pltsavefig0 将 当前 的 Figure 对 象 保存 成 图 像 文件 , 图 像 格式 由 图 像 文 件 的 扩展 
名 决定 。 下 面 的 程序 将 当前 的 图 表 保 存 为 “testpng”， 并 且 通 过 dpi 参数 指定 图 像 的 分 辨 率 为 
120， 因 此 输出 图 像 的 宽度 为 “8X120 = 960” 个 像素 。 
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>>> run matplotlib simple plot.py 
| >>> plt.savefig("test.png"，dpi=126) 


如 果 关闭 了 图 表 窗 口 ， 就 无 法 使 用 savefig0 保 存 图 像 。 实 际 上 不 需要 调用 show0 显 示 
图 表 ， 可 以 直接 用 savefig0 将 图 表 保存 成 图 像 文 件 。 使 用 这 种 方法 可 以 很 容易 编写 出 
批量 输出 图 表 的 程序 。 


savefig0 的 第 一 个 参数 可 以 是 文件 名 ， 也 可 以 是 和 Python 的 文件 对 象 有 相同 调用 接口 的 对 
象 。 例 如 可 以 将 图 像 保 存 到 StringIO 对 象 中 ， 这 样 就 得 到 了 一 个 表示 图 像 内 容 的 字符 串 。 这 里 
| ”需要 使 用 fmt 参数 指定 保存 的 图 像 格式 。 


>>> from StringIO import StringI0 

>>> buf = StringIO() # 创建 一 个 用 来 保存 图 像 内 容 的 StringIO 对 象 
>>> plt.savefig(buf，fmt="png") # 将 图 像 以 png 格式 保存 到 buf 中 
>>> buf.getvalue()[:26] # 显示 图 像 内 容 的 前 29 个 字 节 
“\x89PNG\r\n\x1laN\n\x86\x66\x66\rIHDR\x86\x68\x63 “ 


5.1.2 ”以 面向 对 象 方式 绘图 


matplotlib 实际 上 是 一 套 面 向 对 象 的 绘图 库 ， 它 所 绘制 的 图 表 中 的 每 个 绘图 元 素 ， 例 如 线 
条 、 文 字 、 刻 度 等 在 内 存 中 都 有 一 个 对 象 与 之 对 应 。 为 了 方便 快速 绘图 ，matplotlib 通过 pyplot 
模块 提供 了 一 套 和 MATLAB 类 似 的 绘图 API， 将 众多 绘图 对 象 所 构成 的 复杂 结构 隐藏 在 这 套 
API 内 部 。 我 们 只 需要 调用 pyplot 模块 所 提供 的 函数 ， 就 可 以 实现 快速 绘图 以 及 设置 图 表 的 各 
种 细节 。pyplot 模块 虽然 用 法 简单 ， 但 不 适合 在 较 大 的 应 用 程序 中 使 用 ， 因 此 本 章 将 着 重 介绍 
如 何 使 用 matplotlib 以 面向 对 象 方式 编写 绘图 程序 。 

为 了 将 面向 对 象 的 绘图 库 封装 成 只 使 用 函数 的 调用 接口 ，pyplot 模块 的 内 部 保存 了 当前 图 
表 以 及 当前 子 图 等 信息 。 当 前 的 图 表 和 子 图 可 以 使 用 gcft0 和 gca0 获 得 , 它们 分 别 是 “Get Current 
Figure” 和 “Get Current Axes” 首 字母 的 缩写 。gcf0 获 得 的 是 表示 图 表 的 Figure 对 象 ， 而 gca0 
获得 的 是 表示 子 图 的 Axes 对 象 . 下 面 我 们 在 了 Python 中 运行 上 一 小 节 的 “matplotlib simple plotpy” 
程序 ， 然 后 调用 gct0 和 gca0 查 看 当前 的 Figure 和 Axes 对 象 。 
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>>> run matplotlib_simple_plot.py 

>>> fig = plt.gcf() 

>>> axes = plt.gca() 

>>> fig 

<matplotlib. figure.Figure object at 6x64B36698> 
>>> axes 

<matplotlib.axes.AxesSubplot object at 6x64BD8E76> 


| 在 pyplot 模块 中 ， 许 多 函数 都 是 对 当前 的 Figure 或 Axes 对 象 进行 处 理 ， 例 如 前 面 介绍 的 


plot0、xlabel0、savefig0 等 。 可 以 在 IPython 中 输入 函数 名 并 加 “??”， 查 看 这 些 函数 的 源 代码 ， 
了 解 它们 是 如 何 调用 各 种 对 象 的 方法 进行 绘图 处 理 的 。 例 如 下 面 的 例子 查看 plot0 的 源 程序 ， 
可 以 看 到 plot0 实 际 上 会 通过 gca0 获 得 当前 的 Axes 对 象 ax， 然 后 再 调用 它 的 plot0 方 法 实现 真 
正 的 绘图 。 请 读者 使 用 类 似 的 方法 ， 查 看 pyplot 模块 的 其 他 函数 是 如 何 对 各 种 绘图 对 象 进行 封 
装 的 。 


>>> plt.plot?? 
def plot(*args, **kwargs): 
ax = gca() 
try: 
ret = ax.plot(*args, **kwargs) 
finally: 
ax.hold(washold) 


5.1.3 配置 属性 


使 用 matplotlib 绘制 的 图 表 的 每 个 组 成 部 分 都 和 一 个 对 象 对 应 ， 可 以 通过 调用 这 些 对 象 的 
属性 设置 方法 set_*0 或 pyplot 模块 的 属性 设置 函数 setp0 来 设置 它们 的 属性 值 。 例 如 ，plot0 返 
回 一 个 元 素 类 型 为 Line2D 的 列表 ， 下 面 的 例子 设置 Line2D 对 象 的 属性 : 


>>> x = np.arange(0, 5, 0.1) 

>>> line = plt.plot(x，x*x)[8] # plot 返回 一 个 列表 

>>> line.set_antialiased(False) # 调用 Line2D 对 象 的 set_*() 方 法 来 设置 属性 值 

在 上 面 的 例子 中 ， 通 过 调用 Line2D 对 象 的 set_antialiased(False)， 关 闭 了 它 在 图 表 中 对 应 
曲线 的 反 锯齿 效果 。 下 面 的 语句 同时 绘制 正弦 和 余弦 两 条 曲线 ，lines 是 一 个 有 两 个 Line2D 对 
象 的 列表 : 

>>> lines = plt.plot(x, np.sin(x), x, np.cos(x)) 

调用 setp0 可 以 同时 配置 多 个 对 象 的 属性 ， 这 里 同时 设置 两 条 曲线 的 颜色 和 线 宽 : 


>>> plt.setp(lines, color="r", linewidth=2.0) 


同样 ， 可 以 通过 调用 Line2D 对 象 的 get_*0 或 pltgetp0 来 获取 对 象 的 属性 值 ; 


>>> line.get_linewidth() 

1.6 

>>> plt.getp(lines[6]，"color") # 返回 color 属性 
pr: 
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>>> plt.getp(lines[1]) # 输出 全 部 属性 
alpha = 1.6 

animated = False 

antialiased or aa = True 

axes = Axes(9.125,6.1;6.775x8.8) 


注意 ，getp0 和 setp0 不 同 ， 它 只 能 对 一 个 对 象 进行 操作 ， 它 有 两 种 用 法 : 
e 指定 属性 名 : 返回 对 象 中 某 个 属性 的 值 。 

e 不 指定 属性 名 : 输出 对 象 中 所 有 属性 和 值 。 

下 面 通过 getp0 查 看 Figure 对 象 的 属性 : 


>>> f = plt.gcf() 
>>> plt.getp(f) 
alpha = 1.6 
animated = False 


Figure 对 象 的 axes 属性 是 一 个 列表 , 它 保存 图 表 中 的 所 有 子 图 对 象 。 下 面 的 程序 查看 当前 
图 表 的 axes 属性 ， 可 以 看 出 其 中 包含 gca0 所 获得 的 当前 子 图 对 象 : 


>>> plt.getp(f, "axes") 
[<matplotlib.axes.AxesSubplot object at 9x65CDD176>] 
>>> plt.gca() 

<matplotlib.axes .AxesSubplot object at 86x65CDD176> 


用 plt.getp0 可 以 继续 获取 AxesSubplot 对 象 的 属性 , 例如 它 的 lines 属性 为 子 图 中 的 Line2D 
对 象 列表 : 


>>> alllines = plt.getp(plt.gca(), "lines") 

>>> alllines 

<a list of 3 Line2D objects> 

>>> alllines[8] == line # 其 中 的 第 一 条 曲线 就 是 最 开始 绘制 的 那 条 曲线 


True 


通过 这 种 方法 可 以 很 容易 查看 对 象 的 属性 值 以 及 各 个 对 象 之 间 的 关系 ， 找 到 需要 配置 的 
属性 。 
由 于 matplotlib 实际 上 是 一 套 面 向 对 象 的 绘图 库 , 因此 也 可 以 直接 获取 对 象 的 属性 , 例如: 


>>> f.axes 

[<matplotlib.axes.AxesSubplot object at 89x65CDD176>] 
>>> f.axes[6].1ines 

<a list of 3 Line2D objects> 


5.1.4 ”绘制 多 个 子 图 


一 个 Figure 对 象 可 以 包含 多 个 子 图 (Axes), 在 matplotlib 中 用 Axes 对 象 表示 一 个 绘图 区 域 ， 
在 本 书 中 称 之 为 子 图 。 在 前 面 的 例子 中 ，Figure 对 象 只 包括 一 个 子 图 。 可 以 使 用 subplot0 快 速 


绘制 包含 多 个 子 图 的 图 表 ， 它 的 调用 形式 如 下 : 


subplot (numRows, numCols, plotNum) 


图 表 的 整个 绘图 区 域 被 等 分 为 numRows 行 和 numCols 列 ， 然 后 按照 从 左 到 右 、 从 上 到 下 
的 顺序 对 每 个 区 域 进行 编号 ,， 左上 区 域 的 编号 为 1。plotNum 参数 指定 创建 的 Axes 对 象 所 在 的 


区 域 。 如 果 numRows、numCols 和 plotNum 三 个 参数 都 小 于 10， 就 可 以 把 它们 缩写 成 一 个 整 


数 ， 例 如 subplot(323) 和 subplot(3,2,3) 的 含义 相同 。 如 果 新 创建 的 子 图 和 之 前 创建 的 子 图 区 域 有 


重合 的 部 分 ， 之 前 的 子 图 将 被 删除 。 


下 面 的 程序 创建 如 图 5-2 所 示 的 3 行 2 列 共 6 个 子 图 ， 并 通过 axisbg 参数 给 每 个 子 图 设置 


不 同 的 背景 颜色 ( 见 文 前 彩 插 )。 
for idx, color in enumerate("rgbyck"): 


plt.subplot(321+idx, axisbg=color) 
plt.show() 
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图 5-2 用 subplot0 在 当前 的 Figure 对 象 9 
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如 果 希 望 某 个 子 图 占据 整 行 或 整 列 ， 可 以 按 如 下 形式 调用 subplot0: 


+ 


subplot(221) # 第 一 行 的 左 图 
plt.subplot(222) # 第 一 行 的 右 图 
plt.subplot(212) # 第 二 整 行 
plt.show() 
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程序 的 输出 如 图 5-3 所 示 。 


9.8.8 EE 8 .6 BE 1.8 


图 5-3 将 Figure 分 为 三 个 子 图 


在 绘图 窗口 的 工具 栏 中 ， 有 一 个 名 为 “Configure Subplots” 的 按钮 ， 单 击 它 将 弹出 用 于 调 
节 子 图 间距 和 子 图 与 图 表 边 框 距离 的 对 话 框 。 也 可 以 在 程序 中 调用 subplots_adjust0 调 节 这 些 参 
数 ， 它 有 left、right、bottom、top、wspace 和 hspace 共 6 个 参数 ， 这 些 参数 与 对 话 框 中 的 各 个 
控件 对 应 。 参 数 的 取 值 范围 为 0 到 1， 它 们 是 对 图 表 绘 图 区 域 的 宽 和 高 进行 正规 化 之 后 的 坐标 
或 长 度 。 

subplot0 返 回 它 所 创建 的 Axes 对 象 ， 可 以 将 它 用 变量 保存 起 来 ， 然 后 用 sca0 交 蔡 让 它们 
成 为 当前 Axes 对 象 ， 并 调用 plot0 在 其 中 绘图 。 如 果 需 要 同时 绘制 多 幅 图 表 ， 可 以 给 figure0 
传递 一 个 整数 参数 指定 Figure 对 象 的 序号 ， 如 果 序号 所 指定 的 Figure 对 象 已 经 存在 ， 将 不 创建 
新 的 对 象 ， 而 只 是 让 它 成 为 当前 的 Figure 对 象 。 下 面 的 程序 演示 了 如 何 依次 在 不 同 图 表 的 不 同 
子 图 中 绘制 曲线 。 


a matplotlib_multi figure.py 
同时 在 多 幅 图 表 、 多 个 子 图 中 进行 绘图 


import numpy as np 
import matplotlib.pyplot as pl 七 


plt.figure(1) # 创建 图 表 1 
plt.figure(2) # 创建 图 表 2 
ax1 = plt.subplot(211) # 在 图 表 2 中 创建 子 图 1 
ax2 = plt.subplot(212) # 在 图 表 2 中 创建 子 图 2 


x = np.linspace(96，3，166) 

for i in xrange(5): 
plt.figure(1) @ # 选择 图 表 1 
plt.plot(x, np.exp(i*x/3)) 


plt.sca(ax1) 四 # 选择 图 表 2 的 子 图 1 
plt.plot(x, np.sin(i*x)) 
plt.sca(ax2) # 选择 图 表 2 的 子 图 2 
plt.plot(x, np.cos(i*x)) 


plt.show() 


首先 通过 figure0 创 建 了 两 个 图 表 ， 它 们 的 序号 分 别 为 1 和 2。 然 后 在 图 表 2 中 创建 了 上 下 
并 排 的 两 个 子 图 ， 并 用 变量 axl 和 ax2 保存 。 

在 循环 中 ，@ 先 调用 figure(1) 让 图 表 1 成 为 当前 图 表 ， 并 在 其 中 绘图 。@ 然 后 调用 sca(ax1) 
和 sca(ax2) 分 别 让 子 图 axl 和 ax2 成 为 当前 子 图 ， 并 在 其 中 绘图 。 当 它们 成 为 当前 子 图 时 ， 包 
含 它们 的 图 表 2 也 自动 成 为 当前 图 表 ， 因 此 不 需要 调用 figure(2)。 依 次 在 图 表 1 和 图 表 2 的 两 
个 子 图 之 间 切 换 ， 逐 步 在 其 中 添加 新 的 曲线 ， 效 果 如 图 5-4 所 示 ( 见 文 前 彩 插 )。 


图 5-4 同时 在 多 幅 图 表 、 多 个 子 图 中 进行 绘图 


5.1.5 配置 文件 


绘制 一 幅 图 表 需 要 对 许多 对 象 的 属性 进行 配置 ， 例 如 颜色 、 字 体 、 线 型 ， 等 等 。 我 们 在 绘 
图 时 ， 并 没有 逐一 对 这 些 属性 进行 配置 ， 许 多 都 直接 采用 了 matplotlib 的 默认 配置 。matplotlib 
将 这 些 默 认 配置 保存 在 一 个 名 为 “matplotlibrc” 的 配置 文件 中 ， 通 过 修改 配置 文件 ， 我 们 可 以 
修改 图 表 的 默认 样式 。 

在 matplotlib 中 可 以 使 用 多 个 “matplotlibrc” 配 置 文件 ， 它 们 的 搜索 顺序 如 下 (顺序 靠 前 的 
配置 文件 将 会 被 优先 采用 ): 

e 当前 路 径 : 程序 的 当前 路 径 。 

e 用 户 配 置 路 径 : 通常 在 用 户 文件 夹 的 “.matplotib ”目录 下 ， 可 以 通过 环境 变量 

MATPLOTLIBRC 修改 它 的 位 置 。 

e 系统 配置 路 径 : 保存 在 matplotlib 安装 目录 下 的 mpl-data 中 。 

通过 下 面 的 语句 可 以 获取 用 户 配置 路 径 : 
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>>> import matplotlib 
>>> matplotlib.get configdir() 
‘C:\Documents and Settings\\ 用 户 名 \\.matplotlib" 


通过 下 面 的 语句 可 以 获得 目前 使 用 的 配置 文件 的 路 径 : 


>>> import matplotlib 
>>> matplot1lib.matplotlib_ fname() 
'C:\\Python26\\1ib\\site-packages\\matplotlib\\mpl-data\\matplotlibrc" 


由 于 在 当前 路 径 和 用 户 配 置 路 径 中 都 没有 找到 配置 文件 , 因此 最 后 使 用 的 是 系统 配置 路 径 
下 的 配置 文件 。 如 果 读 者 将 matplotlibre 复制 一 份 到 脚本 的 当前 目录 (例如 c:\zhang\doc) 下 : 


>>> import os 
>>> os.getcwd() 
"“C:N\N\zhang\\doc" 


复制 配置 文件 之 后 再 查看 配置 文件 的 路 径 ， 就 会 发 现 它 变 成 了 当前 目录 下 的 配置 文件 ; 


>>> matplotlib.matplotlib_ fname() 
'C:\\zhang\\doc\\matplotlibrc"' 


如 果 读 者 使 用 文本 编辑 器 打开 此 配置 文件 ， 就 会 发 现 它 实 际 上 是 一 个 字典 。 为 了 对 众多 的 
配置 进行 区 分 ， 字 典 的 键 根据 配置 的 种 类 用 “.” 分 为 多 段 。 
配置 文件 的 读 入 可 以 使 用 re_params0， 它 返回 一 个 配置 字典 : 


>>> matplotlib.rc_params() 

{'agg.path.chunksize': 9， 
"axes.axisbelow': False, 
"axes.edgecolor': ‘'k', 
“axes.facecolor ': 'w', 


matplotlib 模块 在 载 入 时 会 调用 re_params0, 并 把 得 到 的 配置 字典 保存 到 rcParams 变量 中 : 


>>> matplotlib.rcParams 
{'agg.path.chunksize': 9， 
"axes.axisbelow': False, 


matplotlib 将 使 用 rcParams 字典 中 的 配置 进行 绘图 。 用 户 可 以 直接 修改 此 字典 中 的 配置 ， 
所 做 的 改动 会 反映 到 此 后 创建 的 绘图 元 素 上 。 例 如 使 用 下 面 代码 绘制 的 折线 将 带 有 圆 形 的 点 标 
识 符 : 


>>> matplotlib.rcParams["lines.marker"] = "0" 
>>> plt.plot([1,2,3,2]) 
>>> plt.show() 


为 了 方便 对 配置 字典 进行 设置 ， 可 以 使 用 rc0。 下 面 的 例子 可 同时 配置 点 标识 符 、 线 宽 和 
颜色 : 


>>> matplotlib.rc("lines", marker="x", linewidth=2, color="red") 


如 果 希 望 恢复 到 默认 的 配置 (matplotlib 载 入 时 从 配置 文件 读 入 的 配置 )， 可 以 调用 
rcdefaults(): 


>>> matplotlib.rcdefaults() 


如 果 手 工 修改 了 配置 文件 ， 希 望 重 新 从 配置 文件 载 入 最 新 的 配置 ， 可 以 调用 : 


>>> matplotlib.rcParams.update( matplotlib.rc params() ) 


WW 通过 pyplot 模块 也 可 以 使 用 rcParams、rc 和 rcdefaults。 


5.1.6 ”在 图 表 中 显示 中 文 


matplotlib 默认 配置 文件 中 使 用 的 字体 无 法 正确 显示 中 文 。 为 了 让 图 表 能 正确 显示 中 文 ， 
可 以 有 如 下 几 种 解决 方案 : 

。 在 程序 中 直接 指定 字体 。 

。 在 程序 开头 修改 配置 字典 rcParams。 

。 修改 配置 文件 。 

在 matplotlib 中 可 以 通过 字体 名 指定 字体 ， 而 每 个 字体 名 都 与 一 个 字体 文件 相对 应 。 通 过 
下 面 的 程序 可 以 获得 所 有 可 用 的 字体 列表 : 


>>> from matplotlib.font_manager import fontManager 

>>> fontManager.ttflist 

[<Font “cmex16” (cmex16.ttf) normal normal 466 normal>, 

<Font “Bitstream Vera Sans Mono” (VeraMoBd.ttf) normal normal 788 normal>， 


] 


fontManagerttflist 是 matplotlib 的 系统 字体 索引 列表 , 其 中 的 每 个 元 素 都 是 表示 字体 的 Font 
对 象 。 例 如 ， 由 第 一 个 Font 对 象 可 知 ， 字 体 名 “cmex10” 与 字体 文件 “cmex10.ttf” 相 对 应 。 
使 用 下 面 的 语句 可 获得 字体 文件 的 全 路 径 和 字体 名 : 


>>> fontManager.ttflist[6] .name 
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“cmex16 
>>> fontManager.ttflist[6].fname 
"“C:\NPython26\\lib\\site-packages\\matplotlib\\mp1-data\N\fonts\Nttf\\cmex16.ttf 


字体 文件 的 路 径 可 知 , “cmex10” 是 matplotlib 自 带 的 字体 。 下 面 的 程序 利用 字体 索引 
列表 中 的 字体 显示 中 文 文字 ， 效 果 如 图 5-5 所 示 。 


田 


咱 文 让 但 趾 文 香 体 申 文 字 枉 趾 文 它 体 
snith arial unicode ms val consalas mhrid reanpa minche mo 
甲 天 玫 体 字体 甲 天 事 琴 
MN rsaska Mincae Pro tie 
中 文字 体 市 二 吝 傈 申 文字 姓 
Wapata Wincha pre STMettt 
中 文字 体 中 文子 休 
ngata tthle pre mm regagsal 
中 文字 栖 中 六 在 史 
STIhangsaag 5TLitd 
中 文字 体 中 文章 体 
Sastd Nonies Scrhie Pra tszuka botadc Pro 
中 文字 体 趾 文字 体 
garsh Gotic mo Hp 由 crokoft wwt 
中 文字 体 个 交 宗仁 中 文字 床 
STeimwel FasaeT1 liliesan 
3 中 文学 体 中 文字 尺 中 文字 体 
时 ksaska Gothic Pro Nanies Eeehic Pra ararecorhicnpec 
号 中 文字 体 中 皇 记性 下 大字 休 
上 Naeats Mincha Pre Kashs Onthsc Pro Smdrgeas masedhatahotaspo 
全 趾 文春 体 中 文字 体 中 文字 个 中 文 丰 侍 
STMupa wahet rose asd Consalas Worid STaSnwed 
T 中 文字 体 中 文学 体 中 文字 床 村 文字 体 
Warata Gothie pre Karsh Gotaic Fro Ws mache 
绘 中 文字 个 中 文字 条 
制 ral Unicods WG 
精 中 文字 作 
美 
的 wazska ootasc Pro 
中 广 宇 
表 FweTi 
字 文 间作 
masettelahotatywo 
中 文子 体 
ero! Zen ed mcrooft wt 


图 5-5 显示 系统 中 的 中 文字 体 


, matplotlib_fonts.py 
全。 显示 所 有 的 中 文字 体 


from matplotlib.font_manager import fontManager 
import matplotlib.pyplot as plt 
import os 


fig = plt.figure(figsize=(12,6)) 

ax = fig.add_subplot(111) 
plt.subplots_adjust(98, 8, 1, 1, 8, 8) 
plt.xticks([]) 


plt.yticks([]) 
x, y = 6.65，8.68 
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fonts = [font.name for font in fontManager.ttflist if 
os.path.exists(font.fname) and os.stat(font.fname).st_size>le6] © 
font = set(fonts) 
dy = (1.6-y)/(len(fonts)/4 + (len(fonts)%41=6)) 
for font in fonts: 
t = ax.text(Xx，y，U" 中 文字 体 "，{ "fontname' :font，'fontsize' :14}, transform=ax.transAxes) @ 
ax.text(x, y-dy/2, font, transform=ax.transAxes) 
x += 0.25 
if x >= 1.9: 
y te ty 
x= 8.65 
plt.show() 


人 @ 利 用 os 模块 中 的 stat0 获 取 字 体 文件 的 大 小 , 并 保留 字体 索引 列表 中 大 于 1MB 的 所 有 字 
体 文件 。 由 于 中 文字 体 文件 通常 都 很 大 ， 因 此 使 用 这 种 方法 可 以 粗略 地 找 出 所 有 的 中 文字 体 
文件 。 

@ 调 用 子 图 对 象 的 text0 在 其 中 添加 文字 , 注意 文字 必须 是 Unicode 字符 串 。 通 过 一 个 描述 
字体 的 字典 指定 文字 的 字体 ，'fontname' 键 对 应 的 值 就 是 字体 名 。 
由 于 matplotlib 只 搜索 TTF 字体 文件 , 因此 无 法 通过 上 述 方法 使 用 Windows 中 Fonts 目录 
下 的 许多 复合 字体 文件 (*.ttc)。 可 以 直接 创建 使 用 字体 文件 的 FontProperties 对 象 ， 并 使 用 此 对 
象 指定 图 表 中 各 种 文字 的 字体 。 下 面 是 一 个 例子 : 


到 matplotlib_simsun_font.py 
使 用 TTC 字体 文件 


from matplotlib.font_manager import FontProperties 
import matplotlib.pyplot as plt 

import numpy as np 

font = FontProperties(fname=r"c:\windows\fonts\simsun.ttc", size=14) © 
t = np.linspace(9，19，1666) 

y = np.sin(t) 

plt.plot(t，y) 

plt.xlabel(u" 时 间 "，fontproperties=font) @ 
plt.ylabel(u" 振 幅 "，fontproperties=font) 
plt.title(u" 正 弦 波 "，fontproperties=font) 
plt.show() 


@ 创 建 一 个 描述 字体 属性 的 FontProperties 对 象 ， 并 设置 其 fname 属性 为 字体 文件 的 绝对 
路 径 。@ 通 过 fontproperties 参数 将 FontProperties 对 象 传递 给 显示 文字 的 函数 。 

还 可 以 通过 字体 工具 将 TTC 字体 文件 分 解 为 多 个 TIF 字体 文件 ， 并 将 其 复制 到 系统 的 字 
体 文件 夹 中 。 为 了 缩短 启动 时 间 , matplotlib 不 会 每 次 启动 时 都 重新 扫描 所 有 的 字体 文件 并 创建 


谢 困 否 沐 六 翰 敬 一 -qholdeu 


151 


州 图 否 亲 问 得 共 一 -qholdeuw 


152 


Python 科学 计算 


字体 索引 列表 ， 因 此 在 复制 完 字体 文件 之 后 ， 需 要 运行 下 面 的 语句 以 重新 创建 字体 索引 列表 : 


>>> from matplotlib.font manager import _rebuild 
>>> _rebuild() 


还 可 以 直接 修改 配置 字典 ， 设 置 默认 字体 ， 这 样 就 不 需要 在 每 次 绘制 文字 时 设置 字体 了 。 
例如 : 


>>> plt.rcParams["font.family"] = "SimHei" 
>>> plt.plot([1,2,3]) 
>>> plt.xlabel1(8.5,8.5,u" 中 文字 体 ") 


或 者 修改 前 面 介绍 的 配置 文件 ， 修 改 其 中 的 “fontfamily” 配 置 为 : 


font.family: SimHei 


注意 “SimHei” 是 字体 名 ， 请 读者 运行 “matplotlib_fontspy” 查 看 系统 中 所 有 可 用 的 中 文 
字体 名 。 


S.2 Artist 对 象 


matplotlib 是 一 套 面向 对 象 的 绘图 库 ， 它 有 三 个 层次 : 

e@ backend bases FigureCanvas: 图 表 的 绘制 领域 。 

ee backend_bases.Renderer: 知道 如 何在 FigureCanvas 对 象 上 绘图 。 

e aitist Artist， 知 道 如 何 使 用 Renderer 在 FigureCanvas 对 象 上 绘图 。 

FigureCanvas 和 Renderer 需要 处 理 底层 的 绘图 操作 ， 例 如 在 wxPython 界面 上 绘图 或 者 使 
用 PostScript 在 PDF 文件 中 绘图 。Artist 对 象 则 处 理 所 有 的 高 层 结构 ， 例 如 处 理 图 表 、 文 字 和 
曲线 等 各 种 绘图 元 素 的 绘制 和 布局 。 通 常 我 们 只 和 Artist 对 象 打交道 ， 而 不 需要 关心 底层 是 如 
何 实现 绘图 细节 的 。 

Artist 对 象 分 为 简单 类 型 和 容器 类 型 两 种 。 简 单 类 型 的 Artist 对 象 是 标准 的 绘图 元 件 ， 例 
如 Line2D、Rectangle、Text、AxesImage 等 。 而 容器 类 型 则 可 以 包含 许多 简单 类 型 的 Artist 对 
象 ， 使 它们 组 织 成 一 个 整体 ， 例 如 Axis、Axes、Figure 等 。 

直接 创建 Artist 对 象 进行 绘图 的 流程 如 下 : 

(1) 创建 Figure 对 象 。 

(2) 为 Figure 对 象 创建 一 个 或 多 个 Axes 对 象 。 

(3) 调用 Axes 对 象 的 方法 创建 各 种 简单 类 型 的 Artist 对 象 。 

在 下 面 的 程序 中 ， 首 先 调用 figure0 创 建 Figure 对 象 。figure0 是 一 个 辅助 函数 ， 可 以 帮助 
我 们 创建 Figure 对 象 ， 它 会 进行 许多 初始 化 操作 ， 因 此 不 建议 直接 使 用 figure0 创 建 。 然 后 调 
用 Figure 对 象 的 add_axes0 在 其 中 创建 一 个 Axes 对 象 ,add_axes0 的 参数 是 一 个 形 如 [left bottom 


width, height 的 列表 ， 这 些 数值 分 别 指定 所 创建 的 Axes 对 象 在 Figure 对 象 中 的 位 置 和 大 小 , 各 
个 值 的 取 值 范围 都 在 0 到 1 之 间 : 


>>> fig = plt.figure() 
>>> ax = fig.add axes([8.15, 8.1, 8.7, 0.3]) 


然后 调用 Axes 对 象 的 plot0 进 行 绘图 ，plot0 可 以 绘制 一 条 曲线 , 并且 返回 表示 此 曲线 的 
Line2D 对 象 : 

>>> line = ax.plot([1,2,3],[1,2,1])[8] # 返回 的 是 一 个 只 含有 一 个 元 素 的 列表 

>>> ax.lines 

[<matplotlib.lines.Line2D object at 9x6637A3D6>] 

>>> line 

<matplotlib. lines.Line2D object at 89x8637A3D6> 


Axes 对 象 的 lines 属性 是 一 个 包含 其 所 有 曲线 的 列表 ， 如 果 继续 运行 ax.plot0， 所 创建 的 
Line2D 对 象 就 都 会 添加 到 此 列表 中 。 如 果 想 删除 某 条 曲线 ， 直 接 从 此 列表 中 删除 它 即 可 。 

Axes 对 象 还 包括 许多 其 他 的 Artists 对 象 ， 例 如 我 们 可 以 通过 set_xlabel0 设 置 其 X 轴 上 的 
标题 : 


>>> ax.set_xlabel("time") 

如 果 查 看 set_xlabel0 的 源 代码 ， 就 会 发 现 它 是 通过 下 面 的 语句 实现 的 : 
self.xaxis.set_label_ text(xlabel) 

如 果 一 直 跟 踪 下 去 ， 会 发 现 Axes 对 象 的 xaxis 属性 是 一 个 XAxis 对 象 ; 


>>> ax.xaxis 
<matplotlib.axis.XAxis object at 9x866343236> 


XAxis 对 象 的 label 属性 是 一 个 Text 对 象 : 


>>> ax.xaxis.label 
<matplotlib. text.Text object at 6x66343296> 


而 Text 对 象 的 _text 属性 为 我 们 设置 的 值 : 


>>> ax.xaxis.label._ text 
"ime 


这 些 都 是 Artist 对 象 ， 因 此 也 可 以 调用 它们 的 get_*0 来 获得 相应 的 属性 值 : 


>>> ax.xaxis.label.get text() 
"ime 
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5.2.1 Artist 对 象 的 属性 


通过 前 面 的 介绍 我 们 已 经 知道 ， 图 表 中 的 每 个 绘图 元 素 都 用 一 个 Artist 对 象 来 表示 ， 而 每 
个 Artist 对 象 都 有 一 大 堆 属 性 用 来 控制 其 显示 效果 。 例如 Figure 对 象 和 Axes 对 象 都 有 patch 属 
性 作为 其 背景 ， 它 是 一 个 Rectangle 对 象 。 通 过 设置 它 的 属性 可 以 修改 图 表 的 背景 颜色 或 透明 
度 等 属性 ， 下 面 的 例子 将 图 表 的 背景 颜色 设置 为 绿色 : 


>>> fig = plt.figure() 

>>> fig.show() 

>>> fig.patch.set_color("g") # 设置 背景 颜色 为 绿色 
>>> fig.canvas.draw() # 重 绘 界面 


注意 : 在 调用 set_color0 设 置 好 背景 颜色 之 后 ， 设 置 的 背景 颜色 并 不 会 立即 在 界面 上 显示 
出 来 ， 还 需要 调用 fig.canvas.draw0 才 能 更 新 界面 显示 。 
下 面 是 所 有 Artist 对 象 都 拥有 的 一 些 属性 : 
alpha: 透明 度 ， 值 在 0 到 1 之 间 ，0 为 完全 透明 ，1 为 完全 不 透明 。 
animated: 布尔 值 ， 在 绘制 动画 效果 时 使 用 。 
axes: 拥有 此 Artist 对 象 的 Axes 对 象 ， 可 能 为 None。 
clip_box: 对 象 的 裁剪 框 。 
clip_on: 是 否 裁剪 。 
clip_path: 裁剪 的 路 径 。 
contains: 判断 指定 点 是 否 在 对 象 之 上 的 函数 。 
figure: 拥有 此 Artist 对 象 的 Figure 对 象 ， 可 能 为 None。 
label: 文本 标签 。 
picker: 控制 Artist 对 象 的 选取 。 
transform: 控制 偏 移 、 旋 转 、 缩 放 等 坐标 变换 。 
Visible: 是 否 可 见 。 
zorder: 控制 绘图 顺序 。 
Artist 对 象 的 所 有 属性 都 可 以 通过 相应 的 get_*0 和 set_*0 方 法 进行 读 写 , 例如 下 面 的 语句 
将 新 绘制 的 曲线 对 象 的 alpha 属性 设置 为 0.5， 从 而 使 它 变 成 半 透 明 : 


>>> line = plt.plot([1,2,3,2,1]，lw=4)[6] 
>>> line.set_alpha(8.5) 


可 以 使 用 set0 一 次 设置 多 个 属性 : 
>>> line.set(alpha=0.5, zorder=2) 


使 用 前 面 介绍 的 getp0 可 以 方便 地 输出 Artist 对 象 的 所 有 属性 名 及 其 对 应 值 : 


>>> plt.getp(fig.patch) 


aa = True 

alpha = 1.6 

animated = False 
antialiased or aa = True 


5.2.2 ”Figure 容器 


现在 我 们 已 经 知道 如 何 观察 和 修改 某 个 已 知 的 Artist 对 象 的 属性 ， 接 下 来 要 解决 如 何 找到 
指定 的 Artist 对 象 。 前 面 介绍 过 Artist 对 象 分 为 容器 类 型 和 简单 类 型 两 种 ， 这 一 节 让 我 们 详细 
看 看 容器 类 型 。 

在 构成 图 表 的 各 种 Artist 对 象 中 ， 最 上 层 的 Artist 对 象 是 Figure， 它 包含 组 成 图 表 的 所 有 
元 素 。 当 调用 其 add_subplot0 或 add_axes0 方 法 向 图 表 中 添加 子 图 时 , 这 些 子 图 都 将 添加 到 axes 
属性 列表 中 ， 同 时 这 两 个 方法 将 返回 新 创建 的 Axes 对 象 。 注 意 : add_subplot0 和 add_axes0 所 
返回 的 对 象 的 类 型 有 所 不 同 ， 分 别 为 AxesSubplot 和 Axes，AxesSubplot 是 Axes 的 派生 类 。 


>>> fig = plt.figure() 

>>> axl = fig.add_subplot(211) 

>>> ax2 = fig.add_axes([6.1，6.1，6.7，6.3]) 

>>> ax1 

<matplot1lib.axes.AxesSubplot object at 6x656BCA96> 
>>> ax2 

<matplotlib.axes.Axes object at 9x856BC916> 

>>> fig.axes 

[<matplotlib.axes.AxesSubplot object at 6x656BCA96>， 
<matplotlib.axes.Axes object at 6x656BC916>] 


为 了 支持 gca0 等 函数 ，Figure 对 象 的 内 部 保存 有 当前 子 图 的 信息 ， 因 此 不 建议 直接 对 axes 
属性 进行 列表 操作 ， 而 应 该 使 用 add_subplot0、add_axes0、delaxes0 等 方法 进行 子 图 的 添加 和 
删除 操作 。 但 是 使 用 for 循环 对 axes 属性 中 的 每 个 元 素 进行 操作 是 没有 问题 的 ， 下 面 的 语句 将 
打开 所 有 子 图 的 栅 格 显示 : 


>>> for ax in fig.axes: ax.grid(True) 


Figure 对 象 可 以 拥有 自己 的 文字 、 线 条 以 及 图 像 等 简单 类 型 的 Artist 对 象 。Artist 对 象 的 默 
认 坐 标 系统 以 像素 点 为 单位 ， 但 是 可 以 通过 设置 其 transform 属性 修改 所 使 用 的 坐标 系 。 例 如 
Figure 对 象 的 坐标 系 是 以 图 表 的 左下 角 为 坐标 原点 (0.0)， 右 上 和 角 的 坐标 为 (1.1)。 关 于 坐标 变换 
在 后 面 的 章节 还 会 进行 详细 介绍 。 下 面 的 程序 创建 一 个 Figure 对 象 ， 并 在 其 中 添加 两 条 直线 ， 
效果 如 图 5-6 所 示 : 


>>> from matplotlib.lines import Line2D 


州 困 否 新 妾 直下 一 -qholdieu 


155 


谢 图 否 沐 问 直 器 一 -qholdiewu 


156 


Python 科学 计算 


>>> fig = plt.figure() 


>>> linel = Line2D([8,1],[8,1], transform=fig.transFigure, figure=fig, color="r") 
>>> line2 = Line2D([8,1],[1,8], transform=fig.transFigure, figure=fig, color="g") 


>>> fig.lines.extend([line1, line2]) 
>>> fig.show() 


为 了 让 创建 的 Line2D 对 象 使 用 Figure 对 象 的 坐 
标 系 ， 我 们 将 Figure 对 象 的 transFigure 属性 赋 给 
Line2D 对 象 的 transform 属性 。 为 了 让 Line2D 对 象 知 
道 它 是 在 Figure 对 象 中 ， 我 们 还 设置 其 figure 属性 为 
fig。 最 后 还 需要 将 这 两 个 Line2D 对 象 添加 到 Figure 
对 象 的 lines 属性 列表 中 。 

下 面 列 出 了 Figure 对 象 中 包含 其 他 Artist 对 象 的 
属性 : 
axes: Axes 对 象 列 表 。 
patch: 作为 背景 的 Rectangle 对 象 。 


legends: Legend 对 象 列表 ， 用 于 显示 图 示 。 
lines: Line2D 对 象 列表 。 

patches: Patch 对 象 列表 。 

texts: Text 对 象 列表 ， 用 于 显示 文字 。 


5.2.3 ”Axes 容器 


Axes 容器 ( 子 图 ) 是 整个 matplotlib 的 核心 ， 它 包含 了 组 成 图 表 的 众多 Artist 对 象 ， 关 


图 5-6 在 Figure 对 象 中 手工 绘制 直线 


images: FigureImage 对 象 列表 ， 用 于 显示 图 像 。 


F 且 有 


许多 方法 、 函 数 ， 用 于 帮助 我 们 创建 和 修改 这 些 对 象 。 和 Figure 容器 一 样 ， 它 有 一 个 patch 属 
性 作为 背景 , 当 它 是 笛 卡 尔 坐 标 时 , patch 属性 是 一 个 Rectangle 对 象 ; 而 当 它 是 极 坐 标 时, patch 
属性 则 是 Circle 对 象 。 例 如 下 面 的 语句 将 Axes 对 象 的 背景 颜色 设置 为 绿色 : 


>>> fig = plt.figure() 
>>> ax = fig.add_subplot(111) 
>>> ax.patch.set_facecolor("green") 


当 调 用 Axes 对 象 的 绘图 方法 plot0 时 ， 它 将 创建 一 组 Line2D 对 象 ， 并 将 它们 添加 进 Axes 
对 象 的 lines 属性 中 ,最 后 返回 包含 所 有 创建 的 Line2D 对 象 的 列表 。plot0 的 所 有 关键 字 参 数 都 


将 传递 给 这 些 Line2D 对 象 以 设置 它们 的 属性 : 


>>> x, y = np.random.rand(2，166) 


>>> line = ax.plot(x, y, "-", color="blue", linewidth=2)[8] 


>>> line 
<matplotlib.lines.Line2D object at 6x63667636> 


>>> ax.lines 
[<matplotlib.lines.Line2D object at 6x63667636>] 


注意 :plot0 返 回 的 是 一 个 Line2D 对 象 列表 , 因为 我 们 可 以 传递 多 组 X-Y 轴 的 数据 给 plot0， 
同时 绘制 多 条 曲线 。 

与 plot0 类 似 ， 绘 制 柱状 图 的 函数 bar0 和 绘制 直方 统计 图 的 函数 hist0 将 创建 一 个 Patch 对 
象 列 表 ， 每 个 元 素 实际 上 都 是 从 Patch 类 派生 的 Rectangle 对 象 ， 所 创建 的 Patch 对 象 都 添加 进 
Axes 对 象 的 patches 属性 中 : 


>>> ax = fig.add_subplot(111) 

>>> n, bins, rects = ax.hist(np.random.randn(1666)，58，facecolor="blue") 
>>> rects 

<a list of 56 Patch objects> 

>>> rects[8] 

<matplotlib.patches.Rectangle object at 9x65BC2356> 

>>> ax.patches[6] 

<matplotlib.patches.Rectangle object at 9x65BC2356> 


一 般 我 们 不 会 直接 对 lines 或 patches 属性 进行 操作 , 而 是 调用 add_line0 或 add_patch0 等 方 
法 ， 这 些 方法 可 以 帮助 我 们 完成 许多 属性 的 设置 工作 。 下 面 看 一 个 例子 ， 首 先 创建 一 个 Axes 
对 象 ax 和 一 个 Rectangle 对 象 rect: 


>>> fig = plt.figure() 
>>> ax = fig.add_subplot(111) 
>>> rect = plt.Rectangle((1,1)，width=5，height=12) 


查看 rect 的 axes 和 transform 属性 : 


>>> print rect.get_axes() # rect 的 axes 属性 为 空 

None 

>>> rect.get_transform() # rect 的 transform 属性 为 默认 值 
BboxTransformTo(Bbox(array([[ 1., 1.]， 


[ 6., 13.]]))) 
然后 通过 add_patch0 将 rect 添加 到 ax 中 ， 再 次 查看 rect 的 axes 和 tranform 属性 : 


>>> ax.add_patch(rect) # 将 rect 添加 到 ax 中 

<matplotlib.patches.Rectangle object at 6x65C34E56> 

>>> rect.get_axes() # 于 是 rect 的 axes 属性 就 是 ax 

<matplotlib.axes.AxesSubplot object at 8x65C69CB6> 

>>> rect.get_transform() # 和 ax.transData 相同 
。# 太 长 ， 省 略 

>>> ax.transData 


。# 太 长 ， 省 略 
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上 面 的 例子 可 以 看 出 ，add_patch0 帮 助 我 们 设置 了 rect 对 象 的 axes 和 transform 属性 。 


接 下 来 ,为 了 完整 显示 rect, 调用 ax 的 autoscale_view0 方 法 让 它 自动 调节 X-Y 轴 的 显示 范围 : 


>>> ax.get_xlim() # ax 的 X 轴 范围 为 6 到 1， 无 法 显示 完整 的 rect 


(© 


.0, 1.0) 


>>> ax.dataLim._get_bounds() # 数据 的 范围 和 rect 的 大 小 一 致 


(1 


0, 1.0, 5.0, 12.0) 


>>> ax.autoscale_view() # 自动 调整 坐标 轴 范 围 
>>> ax.get_xlim() # 于 是 X 轴 可 以 完整 显示 rect 


(1 


.0, 6.0) 


>>> plt.show() 


下 面 列 出 了 Axes 对 象 中 可 以 包含 其 他 Artist 对 象 的 属性 : 


artists: Artist 对 象 列表 。 

patch: 作为 Axes 背景 的 Patch 对 象 ， 可 以 是 Rectangle 或 Circle。 
collections: Collection 对 象 列表 。 

images: AxesImage 对 象 列 表 。 

legends: Legend 对 象 列表 。 

lines: Line2D 对 象 列表 。 

patches: Patch 对 象 列表 。 

texts: Text 对 象 列表 。 

xaxis: XAxis 对 象 。 

yaxis: YAxis 对 象 。 


表 5-1 列 出 了 Axes 对 象 中 各 种 创建 其 他 Artist 对 象 的 方法 : 


表 5-1_Axes 对 象 中 创建 其 他 Artist 对 象 的 方法 


Axes 的 方法 所 创建 的 对 象 添加 进 的 列表 


anotate texs 


patches 


errorbar Line2D. Rectangle lines.patches 


fill patches 
hist patches 
imshow images 
legend legends 
plot lines 


scatter PolygonCollection Collections 


ts 


我 们 以 绘制 散 列 图 (scatteD 为 例 ， 演 示 绘 图 过 程 中 所 创建 的 各 个 对 象 : 


>>> fig = plt.figure() 

>>> ax = fig.add_subplot(111) 

>>> t = ax.scatter(np.random.rand(26)，np.random.rand(26)) 

>>> t # 返回 值 为 CircleCollection 对 象 
<matplotlib.collections.CircleCollection object at 89x66664236> 
>>> ax.collections # 返回 的 对 象 已 经 添加 到 了 collections 列表 中 
[<matplotlib.collections.CircleCollection object at 6x66664236>] 
>>> fig.show() 

>>> t.get_sizes() # 获得 Collection 的 点 数 

20 


5.2.4 ”Axis 容器 


Axis 容器 包括 坐标 轴 上 的 刻度 线 、 刻 度 标签 、 坐 标 网 格 以 及 坐标 轴 标题 等 内 容 。 刻 度 包 括 
主 刻 度 和 副 刻度 ， 分 别 通过 get_ major ticks0 和 get_minor ticks0 方 法 获得 。 每 个 刻度 线 都 是 一 
个 XTick 或 YTick 对 象 ， 它 包括 实际 的 刻度 线 和 刻度 标签 。 为 了 方便 访问 刻度 线 和 文本 ，Axis 
对 象 提供 了 get_ticklabels0 和 get_ticklines() 方 法 ， 可 以 直接 获得 刻度 标签 和 刻度 线 。 

下 面 我 们 看 一 个 例子 ， 首 先进 行 绘图 并 得 到 当前 子 图 的 X 轴 对 象 axis: 


>>> plt.plot([1,2,3],[4,5,6]) 
[<matplotlib.lines.Line2D object at 9x6AD3B676>] 
>>> plt.show() 

>>> axis = plt.gca().xaxis 


获得 axis 对 象 的 刻度 位 置 列表 : 


>>> axis.get ticklocs() 
mere i eS 2 0 3 


下 面 获得 axis 对 象 的 刻度 标签 以 及 标签 中 的 文字 : 


>>> axis.get_ticklabels() # 获得 刻度 标签 列表 
<a list of 5 Text major ticklabel objects> 


>>> [x.get_text() for x in axis.get_ticklabels()] # 获得 刻度 的 文本 字符 串 
[u'1.0', u'1.5', u'2.0', u'2.5', u'3.0'] 


下 面 获 得 X 轴 上 表示 主 刻度 线 的 列表 ， 我 们 看 到 义 轴 上 共有 10 条 刻度 线 ， 它 是 图 5-7 中 
上 下 两 个 X 轴 上 的 所 有 刻度 线 : 


>>> axis.get ticklines() 
<a list of 10 Line2D ticklines objects> 
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而 由 于 图 5-7 中 没有 副 刻度 线 ， 因 此 副 刻度 线 列表 的 长 度 为 0: 


>>> axis.get_ticklines(minor=True) # 获得 副 刻度 线 列表 
<a list of 8 Line2D ticklines objects> 


获得 刻度 线 或 刻度 标签 之 后 ， 可 以 设置 其 各 种 属性 。 下 面 设置 刻度 线 为 绿色 粗 线 , 文本 为 
红色 并 且 旋 转 45”， 最 终 的 结果 如 图 5-7 所 示 : 


>>> for label in axis.get ticklabels(): 
label.set_color("red") 
label.set_rotation(45) 
label.set fontsize(16) 


>>> for line in axis.get ticklines(): 
line.set_color("green") 
line.set_markersize(25) 
line.set_markeredgewidth(3) 


65.8 
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5-7 手工 配置 X 轴 的 刻度 线 和 刻度 文本 


请 注意 , 这 个 例子 只 是 为 了 演示 Artist 对 象 的 各 种 属性 ,实际 上 使 用 pyplot 模 块 中 的 xticks0 
能 够 更 快 地 完成 X 轴 上 刻度 标签 的 配置 : 


>>> plt.xticks(fontsize=16, color="red", rotation=45) 


xticks0 只 能 设置 刻度 标签 的 属性 ， 不 能 设置 刻度 线 的 属性 。 感 兴趣 的 读者 可 以 在 IPython 
中 输入 “plt.xticks??” 查 看 其 源 代码 。 

上 面 的 例子 中 ， 副 刻度 线 列 表 为 空 ， 这 是 因为 用 于 计算 副 刻度 位 置 的 对 象 默认 为 
NullLocator， 它 不 产生 任何 刻度 线 。 而 计算 主 刻 度 位 置 的 对 象 为 AutoLocator， 它 会 根据 当前 的 
缩放 等 配置 自动 计算 刻度 的 位 置 : 


>>> axis.get_minor_locator() # 计算 副 刻度 位 置 的 对 象 


<matplotlib.ticker.NullLocator instance at 9x6A614366> 
>>> axis.get_major_locator() # 计算 主 刻度 位 置 的 对 象 
<matplotlib.ticker.AutoLocator instance at 6x69281B26> 


matplotlib 提供 了 多 种 配置 刻度 线 位 置 的 Locator 类 ， 


类 。 下 面 的 程序 设置 X 轴 的 主 刻度 为 14， 
显示 x。 程序 的 输出 如 图 5-8 所 示 。 


st matplotlib axis text.py 
自 定义 坐标 轴 的 刻度 和 文字 


import matplotlib.pyplot as pl 


以 及 控制 刻度 标签 显示 的 Formatter 


副 刻度 为 x/20， 并 且 主 刻度 上 的 标签 用 数学 符号 


from matplotlib.ticker import MultipleLocator, FuncFormatter © 


import numpy as np 

x = np.arange(8, 4*np.pi, 8.61) 
y = np.sin(x) 
pl.figure(figsize=(8,4)) 
pl.plot(x, y) 

ax = pl.gca() 


def pi formatter(x, pos): © 


比较 哆 嗪 地 将 数值 转换 为 以 pi/4 为 单位 的 刻度 文本 


m= np.round(x / (np.pi/4)) 
n=4 


while m!=8 and m%2==8: m, n = m//2, n//2 


if m == 
return "@" 
if m== 1 and n == 
return "$\pi$" 
if n == 
return r"$%d \pi$" %m 
if m == 
return r"$\frac{\pi}{%d}$" %n 


return r"$\frac{%d \pi}{%d}$" % (m,n) 


# 设置 两 个 坐标 轴 的 范围 
pl.ylim(-1.5,1.5) 
pl.xlim(8, np.max(x)) 


# 设置 图 的 底 边 距 
pl.subplots_adjust(bottom = 9.15) 
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pl.grid() # 开 启 网 格 


# 主 刻度 为 pi/4 

ax.xaxis.set major_locator( MultipleLocator(np.pi/4) ) © 

# 主 刻度 文本 用 pi_formatter 函数 计算 

ax.xaxis.set_major_formatter( FuncFormatter( pi formatter ) ) @ 
# 副 刻 度 为 pi/28 

ax.xaxis.set minor_ locator( MultipleLocator(np.pi/26) ) © 

# 设置 刻度 文本 的 大 小 

for tick in ax.xaxis.get_major_ticks(): 


tick.1label1.set_fontsize(16) 
pl.show() 


@ 与 刻度 定位 和 文本 格式 化 相关 的 类 都 在 matplotlib.ticker 模块 中 定义 , 程序 从 中 载 入 了 如 
下 两 个 类 : 


e MultipleLocator: @@ 以 指定 值 的 整数 倍 为 刻度 放置 主 、 副 刻度 线 。 

e FuncFormatter: @ 使 用 指定 的 函数 计算 刻度 文本 ， 它 会 将 刻度 值 和 刻度 的 序号 作为 参 
数 传递 给 计算 刻度 文本 的 函数 。 @ 程 序 中 通过 pi_formatter0 计 算出 刻度 值 对 应 的 刻度 
文本 。 


_1.5 h | 让 
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4 2 4 2 4 4 2 4 4 2 4 


图 5-8 配置 X 轴 上 刻度 线 的 位 置 和 文本 ， 并 开启 副 刻 度 线 


5.2.5 ”Artist 对 象 的 关系 


为 了 方便 读者 理解 图 表 中 各 种 Artist 对 象 之 间 的 关系 ， 本 书 提供 了 一 个 输出 Artist 对 象 关 
系 图 的 小 程序 。 


办 graphviz_matplotlib.py 
让 将 Artist 对 象 的 关系 以 Graphviz 格式 的 图 形 语言 输出 


“graphviz_matplotlib.py” 中 的 graphviz0 能 将 Artist 对 象 的 内 部 关系 输出 成 Graphviz 格式 
的 图 形 语 言 : 


>>> from graphviz matplotlib import graphviz 
>>> print graphviz(plt.gcf()) 
digraph structs { 


为 了 将 图 形 语言 转换 成 实际 的 关系 图 ， 读 者 可 以 从 Graphviz 的 官方 网 站 下 载 Graphviz 软 
件 包 ,或 者 使 用 Graphviz 的 在 线 编辑 器 。 


© http://www.graphviz.org 和 http://graph.gafolnet 
Graphviz 的 官方 网 站 和 在 线 编辑 器 


下 面 我 们 看 一 个 例子 。 对 于 由 如 下 程序 产生 的 Figure 对 象 ， 调 用 “graphviz(plt.gcf0)” 将 
得 到 如 图 5-9 所 示 的 关系 图 ”。 


plt.figure() 
plt.subplot(211) 
plt.bar([1,2,3], [1,2,3]) 
plt.subplot(212) 
plt.plot([1,2,3]) 


图 5-9 中 以 灰色 填充 的 矩形 表示 列表 ,其 他 的 矩形 表示 各 种 Artist 对 象 。Artist 对 象 之 间 的 
关系 使 用 带 箭头 的 细 线 表示 ， 细 线 旁 边 的 文本 为 属性 名 。 

例如 , 从 Figure 矩形 到 Rectangle 矩形 的 箭头 表示 Figure 对 象 的 patch 属性 是 一 个 Rectangle 
对 象 ， 而 Figure 对 象 的 axes 属性 是 一 个 含有 两 个 元 素 的 列表 ， 每 个 元 素 都 是 一 个 AxesSubplot 
对 象 。 请 读者 仔细 观察 图 5-9， 并 在 IPython 中 输入 相应 的 语句 以 确认 各 个 Artist 对 象 之 间 的 
关系 。 


四 “graphviz matplotlib py” 中 有 几 个 设置 关系 图 输出 的 选项 ， 它 们 决定 了 哪些 Artist 对 象 的 哪些 属性 将 被 展开 显示 。 
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我 们 可 以 为 图 表 添 加 文字 、 箭 头 以 及 各 种 标注 元 素 ， 对 图 表 中 的 重点 区 域 进行 说 明 。 下 面 


先 看 一 个 例子 : 
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5-9 图 表 中 各 个 Artist 对 象 的 关系 


5.3 ”坐标 变换 和 注释 


matplotlib_annotation.py 
总 为 图 表 添 加 各 种 注释 元 素 


[3 
i | 
a 
ae | ene ,J 
EE 
了 2 
| 
YI Lncay 
# 


import numpy as np 
import matplotlib.pyplot as plt 


def funcl(x): © 
return 0.6*x + 9.3 


def func2(x): © 
return @.4*x*x + 0.1*x + 0.2 


def find_curve_intersects(x, yl1, y2): 
d=yl - y2 
idx = np.where(d[:-1]*d[1:]<=6)[6] 
x1, x2 = x[idx], x[idx+1] 
d1, d2 = d[idx], d[idx+1] 
return -di*(x2-x1)/(d2-d1) + x1 


x = np.linspace(-3,3,166) © 
f1 = func1(x) 

f2 = func2(x) 
plt.figure(figsize=(8,4)) 
plt.plot(x, f1) 

plt.plot(x, f2) 


x1, x2 = find_curve_intersects(x, f1, f2) © 
plt.plot(x1, funci(x1), "o") 
plt.plot(x2, func1i(x2), "o") 


plt.fill between(x, f1, f2, where=f1>f2, facecolor="green", alpha=0.5) @ 


from matplotlib import transforms 

ax = plt.gca() 

trans = transforms.blended transform factory(ax.transData, ax.transAxes) 
plt.fill_between([x1, x2], 8, 1, transform=trans, alpha=0.1) © 


a = plt.text(8.65，6.95，u" 直 线 和 二 次 曲线 的 交点 "， @ 
transform=ax. transAxes, 
verticalalignment = "top", 
fontsize = 18, 
bbox={ "facecolor": "red"，"alpha" :86.4, "pad":19} 
) 


arrow = {"arrowstyle":"fancy, tail_ width=0.6", 


"facecolor":"gray", 
"connectionstyle":"arc3,rad=-0.3"} 


plt.annotate(u" 交 点 "，@ 
xy=(x1, func1(x1)), xycoords="data", 
xytext=(0.65, 0.5), textcoords="axes fraction", 
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arrowprops = arrow) 


plt.annotate(u" 交 点 "，@ 
xy=(x2, func1(x2)), xycoords="data", 
xytext=(0.65, 8.5), textcoords="axes fraction", 
arrowprops = arrow) 

xm = (x1+x2)/2 

ym = (func1(xm) - func2(xm))/2+func2(xm) 

0 = plt.annotate(u" 直 线 大 于 曲线 区 域 "，@ 
xy =(xm，ym)，xycoords="data"， 
xytext = (36，-36)，textcoords="offset points", 
bbox={"boxstyle":"round", "facecolor":(1.0, 0.7, 80.7), "edgecolor":"none"}, 
fontsize=16, 
arrowprops={"arrowstyle":"->"} 

) 

plt.show() 


程序 的 输出 如 图 5-10 所 示 ， 图 中 演示 了 下 面 所 列 出 的 标注 效果 : 

e 用 两 个 小 圆 点 表示 直线 和 曲线 的 两 个 交点 。 

。 对 在 两 个 交点 之 间 且 位 于 直线 和 曲线 之 间 的 面积 进行 了 填充 。 

。 使 用 一 个 高 为 整个 子 图 高 度 、 左 右边 位 于 两 个 交点 的 矩形 来 表示 两 个 交点 之 间 的 区 间 。 
。 在 图 的 左上 角 放置 了 说 明文 字 。 

。 对 两 个 交点 和 填充 面积 使 用 了 带 箭 头 的 注释 说 明 。 


图 5-10 为 图 表 添加 各 种 注释 元 素 


首先 , @ 定 义 了 两 个 函数 funcl 和 func2, 它们 分 别 是 计算 一 条 直线 和 一 条 二 次 曲线 的 函数 。 
然后 @ 计 算 这 两 个 函数 在 区 间 (-3,3) 上 的 值 ， 并 且 调 用 plot0 绘 制 成 曲线 图 。 

目 为 了 标 出 两 个 交点 , 我 们 用 fimnd_curve intersects0 计 算 两 条 曲线 和 也 的 交点 所 对 应 的 
X 轴 坐 标 x1 和 x2。 交 点 处 的 小 圆 点 仍然 使 用 plot0 进 行 绘制 ， 这 时 所 传递 的 X-Y 轴 的 数据 为 
单一 数值 ， 并 且 以 'o 为 样式 进行 绘图 。 


如 何 计算 两 条 曲线 的 交点 

当 两 条 曲线 的 Y 轴 上 坐标 值 yl 和 y2 使 用 相同 的 X 轴 坐 标 数 组 x 计算 时 ， 很 容易 计算 它 
们 的 交点 。 首 先 计算 两 条 曲线 在 Y 轴 的 差 值 d=y1-y2， 然 后 找到 符号 相反 的 两 个 连续 的 差 值 
的 下 标 idx 和 idx+1。 计 算 直 线 (x[idx],d[idx])-(x[idx+1],d[lidx+1D 和 X 轴 的 交点 就 可 得 到 两 条 
曲线 交点 的 义 轴 坐标 xc。 如 果 要 计算 交点 的 立轴 坐标 ， 只 需要 调用 np.interp(xc, x, y1) 对 曲 
线 进行 线性 插值 即 可 。 


@ 接 下 来 调用 fl between0 绘 制 X 轴 上 在 两 个 交点 之 间 、 立 轴 上 在 两 条 曲线 之 间 的 面积 部 
分 ， 并 通过 facecolor 和 alpha 参数 指定 填充 的 颜色 和 透明 度 。fill_ between0 的 调用 参数 如 下 : 


fil1_between(x，y1，y2=8，where=None) 


其 中 ，x 参数 是 长 度 为 N 的 数组 ，yl 和 y2 参数 是 长 度 为 N 的 数组 或 单个 数值 。 当 y1 或 
了 2 为 单个 数值 时 ， 它 们 相当 于 一 个 长 度 为 N、 元 素数 值 都 相同 的 数组 。fill_between0) 将 填充 Y 
轴 在 yl 和 y2 之 间 的 部 分 。 如 果 where 参数 为 None， 将 对 数组 x 中 的 所 有 元 素 进行 填充 ， 如 
果 where 是 一 个 布尔 数组 , 就 只 填充 其 中 True 所 对 应 的 数组 x 的 元 素 。 程序 中 数组 x 的 取 值 范 
围 为 -3,3)， 由 于 设置 了 条 件 “where=f1> 亿 ”， 因 此 仅 绘制 直线 在 二 次 曲线 之 上 的 部 分 。 

@ 绘 制 X 轴 上 在 两 个 交点 之 间 的 矩形 区 域 ，@ 用 text0 在 图 表 中 添加 说 明文 字 ，@ 最 后 用 
annotate() 为 图 表 添加 了 三 个 带 箭 头 的 注释 。 

为 了 真正 理解 程序 的 细节 ， 首 先 需要 了 解 matplotlib 中 坐标 变换 的 工作 原理 。 


5.3.1 4 种 坐标 系 


在 使 用 matplotlib 绘制 的 一 幅 图 表 中 ， 有 4 种 坐标 系 : 
e 数据 坐标 系 : 它 是 描述 数据 空间 中 位 置 的 坐标 系 ， 例 如 对 于 图 5-10， 它 的 数据 坐标 
系 为 X 轴 在 (-3.3) 之 间 、 立 轴 在 (-2.5) 之 间 。 
e 子 图 坐标 系 : 描述 子 图 中 位 置 的 坐标 系 ， 子 图 的 左下 角 坐 标 为 (0.0)， 右 上 角 坐 标 为 
(Ds 
。 图 表 坐 标 系 : 一 幅 图 表 可 以 包含 多 个 子 图 ， 并 且 子 图 周围 都 有 一 定 的 余 白 ， 因 此 还 
需要 用 图 表 坐 标 系 描述 图 表 显 示 区 域 的 某 个 点 , 图 表 的 左下 角 坐 标 为 (0,0), 右上 角 坐 
标 为 (1,1)。 
。 窗口 坐标 系 : 它 是 绘图 窗口 中 以 像素 为 单位 的 坐标 系 。 左 下 角 坐 标 为 (0, 0)， 右 上 角 
坐标 为 (width.height)， 其 中 的 width 和 height 分 别 是 以 像素 为 单位 的 绘图 窗口 的 内 帘 
和 内 高 ， 即 不 包括 标题 栏 、 工 具 条 以 及 状态 栏 等 部 分 。 
Axes 对 象 的 transData 属性 是 数据 坐标 变换 对 象 ，transAxes 属性 是 子 图 坐标 变换 对 象 。 
Figure 对 象 的 transFigure 属性 是 图 表 坐 标 变换 对 象 。 
通过 上 述 坐 标 变换 对 象 的 transform0 方 法 ， 可 以 将 此 坐标 系 下 的 坐标 转换 为 窗口 坐标 系 中 
的 坐标 。 下 面 看 一 个 例子 ， 首 先 在 了 Python 中 运行 “matplotlib_annotation.py” 演 示 程 序 : 
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>>> run matplotlib annotation.py 


下 面 的 程序 计算 数据 坐标 系 中 的 坐标 点 (-3,-2) 和 (3,5) 在 绘图 窗口 中 的 坐标 : 


>>> type(ax.transData) 
<class “matplotlib.transforms.CompositeGenericTransform "> 
>>> ax.transData.transform([(-3,-2),(3,5)]) 
array([[ 86.， 32.], 
[ 576.， 288.]]) 


下 面 的 程序 计算 子 图 坐标 系 中 的 坐标 点 (0.0) 和 (1.1) 在 绘图 窗口 中 的 位 置 ， 得 到 的 结果 和 上 
面 的 程序 相同 。 也 就 是 说 ， 子 图 的 左下 角 坐 标 (0.0) 和 数据 坐标 系 中 的 坐标 (-3,-2) 在 屏幕 上 是 同 
一 个 点 。 观 察 图 5-10 就 可 以 知道 这 显然 是 正确 的 。 


>>> ax.transAxes.transform([(8,0), (1,1)]) 
array([[ 86.， 32.], 
Tsz6w 0 22a 


最 后 计算 图 表 坐 标 系 中 坐标 点 (0.0) 和 (1,1) 在 绘图 窗口 中 的 位 置 ， 可 以 看 出 绘图 区 域 的 宽度 
为 640 个 像素 、 高 度 为 320 个 像素 : 


>>> plt.gcf().transFigure.transform([(8,8), (1,1)]) 
array([[ 6.， 9.]， 
[ 640., 326.]]) 


通过 坐标 变换 对 象 的 inverted0 方 法 , 可 以 获得 它 的 逆 变 换 对 象 。 例如 下 面 的 程序 计算 绘图 
窗口 中 的 坐标 点 (320,160) 在 数据 坐标 系 中 的 坐标 ， 结 果 为 (-0.09677419,1.5): 


>>> inv = ax.transData.inverted() 

>>> type(inv) 

<class "matplotlib.transforms .CompositeGenericTransform "> 
>>> inv.transform((3296，166)) 

array([-6.99677419， 1.5 ]) 


请 读者 仔细 观察 程序 输出 的 图 表 ， 子 图 的 上 下 余 白 相 同 ， 而 左 侧 余 白 略 大 于 右 侧 余 白 ， 
此 绘图 区 域 的 中 心 点 (320,160) 并 不 是 数据 区 域 的 中 心 点 (0, 1.5)。 
当 调 用 xlim0 修 改 子 图 显示 的 义 轴 范围 之 后 ， 它 的 数据 坐标 变换 对 象 也 同时 发 生变 化 : 


>>> plt.xlim(-3,2) # 设置 X 轴 的 范围 为 -3 到 2 

(-3, 2) 

>>> ax.transData.transform((3,5)) # 数据 坐标 变换 对 象 已 经 发 生变 化 
array([ 675.2, 288. ]) 

>>> plt.draw() # 刷新 绘图 区 域 ， 显 示 新 的 绘图 范围 


下 面 我 们 回头 看 看 图 5-10 中 绘制 矩形 区 间 的 程序 : 


from matplotlib import transforms 

ax = plt.gca() 

trans = transforms.blended _ transform factory(ax.transData, ax.transAxes) 
plt.fil1_between([x1，x2]，68，1，transform=trans，alpha=6.1) 


和 拢 形 区 间 使 用 fllL_between0 进 行 绘制 。 由 于 所 绘制 矩形 的 左右 两 边 要 始终 经 过 两 个 交点 ， 
因此 矩形 的 X 轴 坐 标 必 须 使 用 数据 坐标 系 中 的 坐标 : x1 和 x2。 又 由 于 矩形 的 高 度 始终 充满 整 
个 子 图 的 高 度 ， 因 此 和 矩形 的 Y 轴 坐 标 必须 是 子 图 坐标 系 中 的 坐标 : 0 和 1。 

程序 中 ， 使 用 blended_transform factory0 创 建 这 种 混合 坐标 系 。 它 的 两 个 参数 都 是 坐标 变 
换 对 象 ， 它 从 第 一 个 参数 获得 X 轴 的 坐标 变换 ， 从 第 二 个 参数 获得 Y 轴 的 坐标 变换 。 因 此 它 
所 返回 的 坐标 变换 对 象 trans 的 X 轴 使 用 数据 坐标 系 ， 而 Y 轴 使 用 子 图 坐标 系 。 程 序 中 ， 将 混 
合 坐标 变换 对 象 trans 传递 给 凶 1 between0 的 transform 参数 ， 这 样 绘制 的 填充 区 域 就 能 始终 保 
持 左 右 两 边 通过 两 个 交点 ， 而 上 下 两 边 位 于 子 图 边框 之 上 。 


5.3.2 ”坐标 变换 的 步骤 
从 一 个 坐标 系 变换 到 另 一 个 坐标 系 ， 中 间 需 要 经 过 几 个 步 又。 而 且 数据 坐标 系 不 一 定 是 笛 
卡尔 坐标 系 ， 它 可 能 是 极 坐标 系 或 对 数 坐 标 系 。 因 此 坐标 系 的 变换 并 不 是 一 个 简单 的 二 维 仿 射 


变换 (2D Affine Transformation)。 下 面 从 最 简单 的 图 表 坐 标 变换 对 象 transFigure 开始 ， 介 绍 
matplotlib 的 坐标 变换 是 如 何 进行 的 。 


>>> fig = plt.gcf() 
>>> fig.transFigure 
BboxTransformTo( 
TransformedBbox( 
Bbox(array([[ 6.，6.]， 
[ 8., 4.]])), 
Affine2D(array([[ 88.， 86.， 98.], 
[ 6.， 39.， 6.]， 
| G0 1 


) 


这 个 坐标 变换 对 象 的 内 容 有 些 复杂 ， 它 是 一 个 BboxTransformTo 对 象 ， 其 中 包含 一 个 
TransformedBbox 对 象 ， 而 TransformedBbox 对 象 又 包含 一 个 Bbox 对 象 和 一 个 Affine2D 对 象 。 
。 Bbox: 定义 一 个 矩形 区 域 -一 [[x0, y0], [x1, yl]。 在 本 例 中 ， 和 拢 形 的 两 个 顶点 坐标 分 
别 为 (0.0) 和 (8.4)， 它 是 窗口 的 英寸 大 小 ， 通 过 figsize 参数 传递 给 figure0。 
。 Affine2D: 二 维 仿 射 变换 对 象 ， 它 是 一 个 矩阵 ， 通 过 它 和 齐 次 向 量 进 行 乘积 得 到 变换 
之 后 的 坐标 ， 由 于 和 矩阵 中 只 有 对 角 线 上 的 值 不 为 零 ， 因 此 仿 射 变换 只 进行 缩放 变换 。 
它 将 坐标 (x,y) 变 换 为 (80*x, 80*y)。 
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仿 射 变换 

二 维 空间 的 仿 射 变换 矩阵 的 大 小 为 3*3， 为 了 进行 仿 射 变换 需要 使 用 齐 次 坐标 ， 即 用 三 
维 向 量 (x,y,1) 表 示 二 维 平面 上 的 点 (x,y)。 仿 射 变换 就 是 仿 射 甜 阵 和 向 量 的 乘积 。 由 于 变换 和 矩 
阵 最 下 一 行 的 数值 始终 是 (0, 0, )， 因 此 有 时 也 将 它 写成 2*3 的 矩阵 形式 。 


x) faanbo)x 
加 qb ab 月 
L 0 0 1 人 1 
e TransformedBbox: 对 矩形 区 域 进行 仿 射 变换 之 后 得 到 一 个 新 的 矩形 区 域 。 在 本 例 中 ， 


所 得 到 矩形 区 域 的 两 个 顶点 为 (0.0) 和 (640,320)。 它 正好 是 以 像素 点 为 单位 的 窗口 的 大 
小 ， 因 此 仿 射 变 换 矩 阵 中 的 数值 80 实际 上 是 Figure 对 象 的 dpi 属性 ; 


>>> fig.dpi 
86 


e BboxTransformTo: 它 是 一 个 从 单位 矩形 区 域 转换 到 指定 矩形 区 域 的 变换 。 在 本 例 中 ， 
它 是 一 个 将 矩形 区 域 (0.0)-(1.1) 变 换 到 和 矩形 区 域 (0.0)-(640.320) 的 坐标 变换 对 象 ， 因 此 
它 能 将 坐标 从 图 表 坐标 系 转换 为 窗口 坐标 系 中 的 坐标 。 

下 面 的 程序 查看 组 成 变换 的 各 个 部 分 : 


>>> fig.transFigure._boxout 
TransformedBbox(...) 


>>> fig.transFigure._boxout.bounds # 仿 射 变换 后 的 矩形 区 域 
(8.6，6.6，648.6，328.6) 

>>> fig.transFigure._boxout._bbox # 以 英寸 为 单位 的 矩形 区 域 
Bbox(array([[ 96.， 8.]，[ 8., 4.]])) 

>>> fig.transFigure._boxout._transform # 仿 射 变换 对 象 


Affine2D(array([[ 88., 6.， 6.]， 
| 
[ 8@., 9.， 1.]])) 


实际 上 ，fig.transFigure 中 的 仿 射 变换 对 象 可 以 通过 fig.dpi_scale_trans 获得 : 


>>> fig.dpi_scale trans == fig.transFigure._boxout._transform 
True 


接 下 来 查看 子 图 坐标 变换 对 象 的 内 容 : 


>>> ax.transAxes 
BboxTransformTo( 
TransformedBbox( 
Bbox(array([[ 6.125, 80.1 ],[ 6.9 ，6.9 ]]))， 


.. 省略. . . # 这 一 部 分 实际 上 是 fig.transFigure 的 内 容 


) 


我 们 看 到 ax.transAxes 是 一 个 BboxTransformTo 对 象 ， 因 此 它 可 以 将 (0.0)-(1.1) 区 域 变换 为 
另外 一 个 区 域 。 而 此 区 域 是 一 个 TransformedBbox 对 象 ， 它 是 将 矩形 区 域 (0.125.0.1)-(0.9.0.9) 通 
过 fig.transFigure 变换 之 后 得 到 的 区 域 。 因 此 在 ax.transAxes 对 象 内 部 使 用 了 fig.transFigure 
变换 : 


>>> ax.transAxes. boxout. transform == fig.transFigure 
True 


而 此 变换 中 的 矩形 区 域 (0.125, 0.1)-(0.9, 0.9)， 实 际 上 是 子 图 在 图 表 坐 标 系 中 的 位 置 : 


>>> ax.get_position() 
Bbox(array([[ 8.125, @.1 ], [8.9 ,8.9 ]])) 


子 图 在 窗口 坐标 系 中 的 矩形 区 域 为 ; 


>>> ax.transAxes._boxout.bounds 
(89.6，31.999999999999993，496.9，256.6) 


因此 , ax.transAxes 实际 上 是 一 个 将 矩形 区 域 (0.0)-(1,1) 变 换 到 矩形 区 域 (80.0.32)-(496.0, 256.0) 
的 坐标 变换 对 象 。 

最 后 我 们 观察 一 下 数据 坐标 系 的 变换 对 象 ax.transData。 由 于 ax.transData 由 ax.transScale、 
ax.transLimits 和 ax.transAxes 共同 构成 ， 因 此 先 看 看 ax.transLimits 和 ax.transScale 的 内 容 。 
transLimits 是 一 个 BboxTransformFrom 对 象 ， 它 是 一 个 将 指定 矩形 区 域 变 换 为 (0.0)-(1.1) 矩 形 区 
域 的 变换 对 象 。 


>>> ax.transLimits 
BboxTransformFrom( 
TransformedBbox( 
Bbox(array([[-3., -2.], [ 3.，5.]]))， 
Transformwrapper(BlendedAffine2D(IdentityTransform(),IdentityTransform())) 


而 transLimits 的 源 矩 形 区 域 为 一 个 TransformedBbox 对 象 , 它 是 一 个 将 矩形 区 域 (-3,-2)-(3.5) 
通过 坐标 变换 之 后 得 到 的 矩形 区 域 。 而 此 处 的 变换 由 如 下 程序 定义 , 它 实际 上 是 一 个 恒 等 变换 : 


Transformwrapper(BlendedAffine2D(IdentityTransform(), IdentityTransform())) 


因此 transLimits 的 最 终 效 果 就 是 将 矩形 区 域 (-3,-2)-(3.5) 变 换 为 矩形 区 域 (0.0)-(1.1): 
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>>> ax.transLimits.transform((-3,-2)) 
array([ 6.， 6.]) 

>>> ax.transLimits.transform((3,5)) 
array([ 2. 1.]) 


而 和 矩形 区 域 (-3,-2)-(3.5) 实 际 上 由 XX 轴 和 立轴 的 显示 范围 决定 : 


>>> ax.get_xlim() # 获得 X 轴 的 显示 范围 
(-3.0, 3.0) 
>>> ax.get_ylim() # 获得 Y 轴 的 显示 范围 
(-2.6，5.6) 


由 于 transLimits 将 数据 坐标 系 的 显示 范围 变换 为 单位 矩形 ， 而 transAxes 将 单位 矩形 变换 
为 以 像素 为 单位 的 窗口 矩形 范围 ， 因 此 这 两 个 变换 的 综合 效果 就 是 将 数据 坐标 变换 为 窗口 坐 
标 。 我 们 可 以 用 “+” 号 将 两 个 变换 连接 起 来 创建 一 个 新 的 变换 对 象 ， 例 如 “ax.transLimits + 
ax.transAxes” 表 示 先 进行 ax.transLimits 变换 ， 然 后 进行 ax.transAxes 变换 ， 变 换 对 象 就 像 流 水 
线 上 生产 产品 一 样 ， 一 步 一 步 地 对 坐标 点 进行 变换 。 下 面 的 程序 比较 它 和 ax.transData 的 变换 
结果 : 


>>> 七 = ax.transLimits + ax.transAxes 
>>> 七 .transform((8,6)) 


array([ 328. ， 165.14285714]) 
>>> ax.transData.transform((6,6)) 
array([ 328. ， 165.14285714]) 


实际 上 , 为 了 支持 不 同比 例 的 坐标 轴 , transData 中 还 包括 一 个 tansScale 变换 , 即 “transData 
= transScale + transLimits + transAxes”。 由 于 本 例 中 ，transScale 是 一 个 恒 等 变 换 ， 因 此 
“ax.transLimits + ax.transAxes” 和 ax.transData 的 变换 效果 一 样 : 


>>> ax.transSscale 
Transformwrapper(BlendedAffine2D(IdentityTransform(),IdentityTransform())) 


当 使 用 semilogx0、semilogy0 以 及 loglog0 等 绘图 函数 绘制 对 数 坐 标 轴 的 图 表 时 ， 或 者 使 
用 Axes 的 set_ xscale0 和 set_yscale0 等 方法 将 坐标 轴 设 置 为 对 数 坐标 时 ，transScale 就 不 再 是 恒 
等 变换 了 : 


>>> ax.set_xscale("log") # 将 X 轴 改 为 对 数 坐标 

>>> ax.transScale 

Transformwrapper(BlendedGenericTransform( 
<matplotlib.scale.Log16Transform object at 6x613A7B56>， 
IdentityTransform())) 

>>> ax.set_xscale("linear") # 将 X 轴 改 为 线性 坐标 


由 于 本 例 中 义 轴 的 取 值 范围 是 (-3,3)， 因 此 如 果 将 义 轴 改 为 对 数 坐标 , 并 且 重 新 绘图 
的 话 ,会 产生 很 多 错误 信息 。 


5.3.3 ”制作 阴影 效果 


下 面 用 我 们 学 到 的 坐标 变换 的 知识 绘制 一 个 带 阴影 效果 的 曲线 。 完 整 的 程序 如 下 ,效果 如 
图 5-11 所 示 。 


ah matplotlib_shadow.py 
通过 坐标 变换 为 曲线 添加 阴影 


import numpy as np 
import matplotlib.pyplot as plt 
import matplotlib.transforms as transforms 


x = np.arange(9.，2.，6.61) 
y = np.sin(2*np.pi*x) 


N = 7 # 阴影 的 条 数 
for i in xrange(N, 80, -1): 
offset = transforms.ScaledTranslation(i, -i, transforms.IdentityTransform()) © 
shadow_trans = plt.gca().transData + offset @ 
plt.plot(x,y,1linewidth=4, color="black", 
transform=shadow_trans, © 
alpha=(N-i)/2.6/N) 


plt.plot(x,y,1linewidth=4,color="black') 
plt.ylim((-1.5, 1.5)) 
plt.show() 


1.0 EE 1.8 1.5 2.9 


图 5-11 使 用 坐标 变换 绘制 的 带 阴影 的 曲线 
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程序 中 , 首先 使 用 循环 绘制 N 条 透明 度 和 偏 移 量 逐 渐变 化 的 曲线 ,然后 再 绘制 实际 的 曲线 
以 实现 阴影 效果 。 

@offset 是 一 个 ScaledTranslation 对 象 ， 它 的 第 一 个 和 第 二 个 参数 决定 了 XX 轴 和 YY 轴 的 偏 
移 量 ， 而 第 三 个 参数 是 一 个 坐标 变换 对 象 ， 经 过 它 变换 之 后 ， 再 进行 偏 移 变 换 。 由 于 程序 中 的 
第 三 个 参数 是 一 个 恒 等 变 换 ， 因 此 offset 实际 上 是 一 个 单纯 的 偏 移 变 换 : 对 X 轴 坐 标 增 加 i， 
对 立轴 坐标 减少 i。 

可 以 通过 IPython 查看 最 后 的 i 为 1 时 的 offset: 


>>> run matplotlib shadow.py 
| >>> offset.transform((8,9)) # 将 (9,8) 变 换 为 (1, -1) 
| array([ 1., -1.]) 


@ 阴 影 曲线 的 坐标 变换 由 shadow_trans 完成 ， 它 由 数据 坐标 变换 对 象 tansData 和 offset 
组 成 : 


>>> plt.gca().transData.transform((8,6)) # 对 (9,9) 进 行 数据 坐标 变换 
array([ 86.， 246.]) 

>>> shadow_trans.transform((6,6)) # 对 (6,6) 进 行 数据 坐标 变换 和 偏 移 变换 
array([ 81.， 239.]) 


目 最 后 通过 transform 参数 将 shadow_trans 传递 给 plot0 进 行 绘图 。 由 于 shadow_trans 是 在 
完成 数据 坐标 到 窗口 坐标 的 变换 之 后 、 再 进行 偏 移 变换 的 ， 因 此 无 论 当 前 的 缩放 比例 如 何 ， 阴 
影 效 果 将 始终 保持 一 致 。 


5.3.4 添加 注释 


pyplot 模块 中 提供 了 两 个 绘制 文字 的 函数 : text0 和 figtext0。 它 们 分 别 调用 当前 Axes 对 象 
和 当前 Figure 对 象 的 text0 方 法 进行 绘图 。text0 默 认 在 数据 坐标 系 中 添加 文字 ， 而 figtext0 则 默 
认 在 图 表 坐 标 系 中 添加 文字 。 可 以 通过 transform 参数 改变 文字 所 在 的 坐标 系 ， 下 面 的 程序 演 
示 了 如 何在 数据 坐标 系 、 子 图 坐标 系 以 及 图 表 坐 标 系 中 添加 文字 。 


州 轿 否 沐 益 坦 器 一 -qholdewu 


# matplotlib_text.py 
让 > 在 数据 坐标 系 、 子 图 坐标 系 以 及 图 表 坐 标 系 中 添加 文字 


import matplotlib.pyplot as plt 
import numpy as np 


x = np.linspace(-1,1,16) 
y = x**2 


fig = plt.figure(figsize=(8,4)) 
ax = plt.subplot(111) 
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plt.plot(x,y) 


for i, (_x, _y) in enumerate(zip(x, y)): 
plt.text(_x, _y, str(i), color="red", fontsize=i+10) © 


plt.text(8.5，8.8，u" 子 图 坐标 系 中 的 文字 "，color="blue"，ha="center"， 
transform=ax.transAxes) ©@ 


plt.figtext(9.1，6.92，u" 图 表 坐 标 系 中 的 文字 "，color="green") 目 


plt.show() 


@ 由 于 没有 设置 transform 参数 ，text0 默 认 将 在 数据 坐标 系 中 创建 文字 ， 这 里 通过 fontsize 
参数 修改 文字 的 大 小 。@ 通 过 transform 参数 将 文字 的 坐标 变换 改 为 ax.transAxes， 因 此 文字 在 
子 图 坐标 系 中 。ha 参数 为 center 表示 坐标 点 (0.5, 0.8) 在 水 平方 向 上 是 文字 的 中 心 , ha 是 horizontal 
alignment 的 缩写 ， 含 义 是 水 平 对 齐 。@ 调 用 figtext0 在 图 表 坐 标 系 中 添加 文字 。 

程序 的 输出 如 图 5-12 所 示 。 请 读者 使 用 缩放 和 平移 工具 改变 子 图 的 显示 范围 ， 会 发 现 数 
据 坐标 系 中 的 文字 将 跟随 曲线 一 起 移动 ， 而 其 他 两 个 坐标 系 中 的 文字 位 置 不 变 。 单 击 绘图 窗口 
工具 栏 中 的 倒数 第 二 个 图 标 按钮 ， 打 开 “Subplot Configuration Tool” 对 话 框 ， 调 节 top、right、 
bottom 和 left 等 参数 ， 会 发 现 子 图 坐标 系 中 的 文字 也 会 跟着 改变 位 置 ， 但 水 平方 向 上 它 和 子 图 
的 中 心 始终 保持 一 致 。 而 图 表 坐 标 系 中 文字 的 位 置 ， 只 有 在 改变 窗口 大 小 时 才 会 发 生变 化 。 


a -09.5 ,9 ,5 1.9 


图 5-12 ”三 个 坐标 系 中 的 文字 


绘制 文字 的 函数 还 有 许多 关键 字 参 数 , 可 以 设置 文字 、 外 框 的 样式 , 请 读者 参考 matplotlib 
的 用 户 手册 ， 这 里 就 不 再 详细 介绍 了 。 
通过 pyplot 模块 的 annotate0 可 以 绘制 带 箭头 的 注释 文字 。annotate0 的 调用 格式 如 下 : 


annotate(s, xy, xytext=None, xycoords="data', textcoords="data', arrowprops=None, ...) 


其 中 , s 参数 是 注释 文本 , xy 是 箭头 所 指 位 置 的 坐标 , xytext 是 注释 文本 所 在 的 坐标 , xycoords 
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和 textcoords 分 别 指定 箭头 坐标 和 注释 文本 坐标 的 坐标 变换 方式 。 

带 箭 头 的 注释 需要 指定 两 个 坐标 : 箭头 所 指 位 置 的 坐标 和 注释 文字 所 在 的 坐标 。 而 这 两 个 
坐标 可 以 使 用 不 同 的 坐标 变换 方法 转换 为 窗口 坐标 。xycoords 和 textcoords 参数 的 值 都 是 字符 
串 ， 它 们 可 以 有 表 5-2 所 示 的 几 种 选项 : 


表 5-2 xycoords 和 textcoords 参数 的 属性 值 


属 性 值 坐标 变换 方式 
figure points 以 点 为 单位 ， 相 对 于 图 表 左 下 角 的 坐标 
figure pixels 以 像素 为 单位 ， 相 对 于 图 表 左 下 角 的 坐标 
figure fraction 图 表 坐 标 系 中 的 坐标 
axes points 以 点 为 单位 ， 相 对 于 子 图 左下 角 的 坐标 
axes pixels 以 像素 为 单位 ， 相 对 于 子 图 左下 角 的 坐标 
axes fraction 子 图 坐标 系 中 的 坐标 
data 数据 坐标 系 中 的 坐标 
offset points 以 点 为 单位 ， 相 对 于 点 xy 的 坐标 
polar 数据 坐标 系 中 的 极 坐标 


其 中 ，'figure fraction'、'axes fraction' 和 'data' 分 别 表 示 使 用 图 表 坐标 系 、 子 图 坐标 系 和 数据 
坐标 系 中 的 坐标 变换 对 象 。 由 于 图 表 和 子 图 坐标 系 都 是 正规 化 之 后 的 坐标 系 ， 使 用 起 来 不 太 方 
便 ， 因 此 对 于 图 表 和 子 图 还 分 别提 供 了 以 点 和 像素 为 单位 的 坐标 变换 方式 。 点 和 像素 的 单位 类 
似 ， 但 是 它 不 会 随 图 表 的 dpi 属性 值 而 发 生变 化 ， 它 始终 以 每 英寸 72 个 点 进行 计算 。 

上 述 几 种 坐标 变换 都 以 固定 的 点 为 原点 进行 变换 , 有 时 我 们 希望 以 距离 箭头 的 偏 移 量 指定 
文字 的 坐标 ， 这 时 可 以 使 用 offset points' 选 项 。 

在 图 5-10 中 ， 所 有 注释 的 箭头 坐标 都 采用 'data'， 因 此 无 论 如 何 放 大 或 平移 绘图 区 域 ， 箭 
头 都 始终 指向 数据 坐标 系 中 的 固定 点 。 而 注释 文本 “交点 ”的 坐标 变换 方式 采用 'axes fraction'， 
因此 “交点 ”始终 保持 在 子 图 中 的 固定 位 置 。 而 “直线 大 于 曲线 区 域 ”注释 文本 的 坐标 采用 'offset 
points 变换 ， 因 此 文字 和 箭头 的 相对 位 置 始 终 保持 不 变 。 

有 兴趣 的 读者 可 以 查看 matplotlib 中 关于 注释 的 坐标 变换 的 源 程序 ， 从 而 更 深入 地 研究 坐 
标 变换 : 


和 A# ci\Python26\Lib\site-packages\matplotlib\text.py 
之 全 关于 坐标 变换 的 程序 在 此 文件 中 的 Annotation，get_xy0 中 定义 


最 后 ，arrowprops 参数 是 一 个 描述 箭头 样式 的 字典 。 关 于 注释 样式 的 详细 配置 请 参考 
matplotlib 的 相关 文档 : 


http://matplotlib.sourceforge.net/users/annotations_guide.html 
matplotlib 官方 网 站 中 关于 注释 的 文档 


» 


S.4 ”绘图 函数 简介 


作为 本 章 的 最 后 一 节 ， 让 我 们 看 看 如 何 用 matplotlib 绘制 一 些 常用 的 图 表 。 本 节 介绍 的 每 
个 绘图 函数 都 有 许多 关键 字 参 数 ， 用 来 设置 图 表 的 各 种 属性 ， 由 于 篇 幅 有 限 ， 本 书 不 能 对 其 一 
一 进行 介绍 。 一 般 来 说 ， 如 果 读 者 需要 对 图 表 进 行 某 种 特殊 的 设置 ， 都 可 以 在 绘图 函数 的 说 明 
文档 或 matploblib 的 演示 页 面 中 找到 相关 的 说 明 。 


5.4.1 ”对 数 坐标 图 


前 面 介绍 过 如 何 使 用 plot0 绘 制 曲 线 图 ， 所 绘制 图 表 的 X-Y 轴 坐 标 都 是 算术 坐标 。 下 面 看 
看 如 何在 对 数 坐标 系 中 绘图 。 

绘制 对 数 坐 标 图 的 函数 有 三 个 : semilogx0、semilogy0 和 loglog0， 它 们 分 别 绘制 X 轴 为 
对 数 坐标 、Y 轴 为 对 数 坐标 以 及 两 个 轴 都 为 对 数 坐标 时 的 图 表 。 


在 对 数 坐 标 图 中 , 因为 轴 上 的 刻度 文本 使 用 LaTex 公式 表示 指数 , 所 以 图 表 的 重 绘 比 
较 费时 。 


下 面 的 程序 使 用 4 种 不 同 的 坐标 系 绘制 低 通 滤波 器 的 频率 响应 曲线 ， 结 果 如 图 5-13 所 示 。 
其 中 ， 左 上 图 为 plot0 绘 制 的 算术 坐标 系 ， 右 上 图 为 semilogx0 绘 制 的 X 轴 对 数 坐标 系 ,左下 图 
为 semilogy0 绘 制 的 Y 轴 对 数 坐 标 系 , 右 下 图 为 loglog0 绘 制 的 双 对 数 坐标 系 。 使 用 双 对 数 坐标 
系 表示 的 频率 响应 曲线 通常 被 称 为 波 特 图 。 


> d Imatplotlib log.py 
完 用 4 种 不 同 的 坐标 系 绘制 低 通 滤波 器 的 频率 响应 曲线 


w = np.linspace(86.1，16686，1666) 
p = np.abs(1/(1+6.1j*w)) # 计算 低 通 滤波 器 的 频率 响应 


plt.subplot(221) 
plt.plot(w, p, linewidth=2) 
plt.ylim(8,1.5) 


plt.subplot(222) 
plt.semilogx(w, p, linewidth=2) 
plt.ylim(8,1.5) 


plt.subplot(223) 
plt.semilogy(w, p, linewidth=2) 
plt.ylim(8,1.5) 
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plt.subplot(224) 
plt.loglog(w, p, linewidth=2) 
plt.ylim(@,1.5) 


3 
图 5-13” 低 通 滤波 器 的 频率 响应 曲线 


5.4.2 ” 极 坐标 图 


极 坐 标 系 是 和 笛 卡 尔 CX-Y) 坐 标 系 完全 不 同 的 坐标 系 ， 极 坐标 系 中 的 点 由 一 个 夹 角 和 一 段 
相对 中 心 点 的 距离 来 表示 。 下 面 的 程序 绘制 极 坐标 图 ， 效 果 如 图 5-14 所 示 ( 见 文 前 彩 插 )。 


a matplotlib_polar.py 
守 _* 在 极 坐 标 中 绘图 


theta = np.arange(0, 2*np.pi, 0.02) 


plt.subplot(121, polar=True) © 
plt.plot(theta, 1.6*np.ones_like(theta), linewidth=2) @ 
plt.plot(3*theta, theta/3, "--", linewidth=2) 


plt.subplot(122, polar=True) 

plt.plot(theta, 1.4*np.cos(S*theta), "--", linewidth=2) 
plt.plot(theta, 1.8*np.cos(4*theta), linewidth=2) 
plt.rgrids(np.arange(90.5, 2, 6.5), angle=45) © 
plt.thetagrids([6，45]) @ 


图 5-14 极 坐标 中 的 圆 、 螺 旋 线 和 玫瑰 线 


人 @ 调 用 subplot0 创 建 子 图 时 通过 设置 polar 参数 为 Tme， 创 建 一 个 极 坐 标 子 图 。@ 然 后 调 
用 plot0 在 极 坐标 子 图 中 绘图 。 也 可 以 使 用 polar0 直 接 创建 极 坐标 子 图 并 在 其 中 绘制 曲线 。 

@rgrids0 设 置 同心 圆 栅 格 的 半径 大 小 和 文字 标注 的 角度 。 因 此 右 图 中 的 虚线 圆圈 有 三 个 ， 
半径 分 别 为 05、1.0 和 1.5， 这 些 文字 沿 着 45° 线 排列 。@thetagrids0 设 置 放射 线 栅 格 的 角度 ， 
因此 右 图 中 只 有 两 条 放射 线 ， 角 度 分 别 为 0" 和 45”。 


5.4.3 ”柱状 图 


柱状 图 用 其 每 根 柱子 的 长 度 表 示 值 的 大 小 ， 它 们 通常 用 来 比较 两 组 或 多 组 值 。 下 面 的 程序 
从 文件 中 读 入 中 国人 口 的 年 龄 分 布 数据 ?， 并 使 用 柱状 图 比较 男性 和 女性 的 年 龄 分 布 ， 效 果 如 
图 5-15 所 示 ( 见 文 前 彩 插 )。 


a matplotlib_bar.py 
绘制 比较 男女 人 口 的 年 龄 分 布 图 


data = np.loadtxt("china_population.txt") 

width = (data[1,6] - data[6,6])*6.4 © 

plt.figure(figsize=(8,5)) 

plt.bar(data[:,8]-width, data[:,1]/1e7, width, color="b", label=u" 男 ") ©@ 
plt.bar(data[:,8], data[:,2]/1e7, width, color="r", label=u" 女 ") © 
plt.xlim(-width，166) 

plt.xlabel(u" 年 龄 ") 

plt.ylabel(u" 人 口 ( 千 万 )") 

plt.legend() 


@ 人 口 分 布 数据 由 维基 百科 提供 ， 仅 供 参考 ， 不 保证 其 正确 性 - 
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图 5-15 中国 男 女人 口 的 年 龄 分 布 图 


读 入 的 数据 中 ， 第 0 列 为 年 龄 ， 它 将 作为 柱状 图 的 横 坐 标 。 人 首先 计算 柱状 图 中 每 根 柱子 
的 宽度 ， 因 为 我 们 要 在 每 个 年 龄 段 上 绘制 两 根 柱子 ， 因 此 柱子 的 宽度 应 该 小 于 年 龄 段 的 二 分 之 
一 。 这 里 以 年 龄 段 的 0.4 倍 作为 柱子 的 宽度 。 

@ 调 用 bar0 绘 制 男性 人 口 分 布 的 柱状 图 。 它 的 第 一 个 参数 为 每 根 柱子 左边 缘 的 模 坐 标 , 为 
了 让 男性 和 女性 的 柱子 以 年 龄 刻度 为 中 心 ， 这 里 让 每 根 柱子 左 侧 的 横 坐 标 为 “年 龄 减 去 柱子 的 
宽度 ”。bar0 的 第 二 个 参数 为 每 根 柱子 的 高 度 ， 第 三 个 参数 指定 所 有 柱子 的 宽度 。 当 第 三 个 参 
数 为 序列 时 ， 可 以 为 每 根 柱子 指定 宽度 。 

自 绘制 女性 人 口 分 布 的 柱状 图 ， 这 里 以 年 龄 为 柱子 的 左边 缘 横 坐标 ,因此 女性 和 男性 的 人 
口 分 布 图 以 年 龄 刻度 为 中 心 。 由 于 bar0 不 自动 修改 颜色 ， 因 此 程序 中 通过 color 参数 设置 两 个 
柱状 图 的 颜色 。 


5.4.4” 散 列 图 


使 用 plot0 绘 图 时 ， 如 果 指 定 样式 参数 为 仅 绘制 数据 点 ， 那 么 所 绘制 的 就 是 一 幅 散 列 图 。 
例如 : 


>>> plt.plot(np.random.random(1686)，np.random.random(168)，"o") 


但 是 这 种 方法 所 绘制 的 点 无 法 单独 指定 颜色 和 大 小 。 而 scatter0 所 绘制 的 散 列 图 却 可 以 指定 
每 个 点 的 颜色 和 大 小 。 下 面 的 程序 演示 scatter0 的 用 法 ， 效 果 如 图 5-16 所 示 ( 见 文 前 彩 插 )。 


# matplotlib_scatter.py 


过 


六 一 绘制 散 列 图 


plt.figure(figsize=(8,4)) 
x = np.random.random(166) 
y = np.random.random(166) 


plt.scatter(x, y, s=x*1080, c=y, marker=(5, 1), alpha=8.8, lw=2, facecolors="none") 


plt.xlim(8,1) 
plt.ylim(8,1) 
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图 5-16 可 指定 每 个 点 的 颜色 和 大 小 的 散 列 图 


scatter0 的 前 两 个 参数 是 数组 ， 分 别 指定 每 个 点 的 X 轴 和 YY 轴 的 坐标 。s 参数 指定 点 的 大 
小 ， 值 和 点 的 面积 成 正比 。 它 可 以 是 一 个 数 ， 指 定 所 有 点 的 大 小 ; 也 可 以 是 数组 ， 分 别 对 每 个 
点 指定 大 小 。 

c 参数 指定 每 个 点 的 颜色 ， 可 以 是 数值 或 数组 。 这 里 使 用 一 维 数组 为 每 个 点 指定 了 一 个 数 
值 。 通 过 颜色 映射 表 ， 每 个 数值 都 会 与 一 个 颜色 相对 应 。 默 认 的 颜色 映射 表 中 蓝 色 与 最 小 值 对 
应 ， 红 色 与 最 大 值 对 应 。 当 c 参数 是 形状 为 (N,3) 或 (N,4) 的 二 维 数组 时 ， 则 直接 表示 每 个 点 的 
RGB 颜色 。 

marker 参数 设置 点 的 形状 ， 可 以 是 一 个 表示 形状 的 字符 串 ， 也 可 以 是 表示 多 边 形 的 两 个 元 
素 的 元 组 ， 第 一 个 元 素 表 示 多 边 形 的 边 数 ， 第 二 个 元 素 表 示 多 边 形 的 样式 ， 取 值 范围 为 0、1、 
2、3。0 表示 多 边 形 ，1 表示 星 形 ，2 表示 放射 形 ，3 表示 忽略 边 数 而 显示 为 圆 形 。 

最 后 ， 通 过 alpha 参数 设置 点 的 透明 度 ， 通 过 lw 参数 设置 线 宽 ，Iw 是 line width 的 缩写 。 
facecolors 参数 为 "one" 时 ， 表 示 散 列 点 没有 填充 色 。 


5.4.5 图像 


inread0 和 imshow0 提 供 了 简单 的 图 像 载 入 和 显示 功能 。 

imread0 可 以 从 图 像 文 件 读 入 数据 ， 得 到 一 个 表示 图 像 的 NumpPy 数组 。 它 的 第 一 个 参数 是 
文件 名 或 文件 对 象 ，format 参数 指定 图 像 类 型 ， 如 果 省 略 ， 就 由 文件 的 扩展 名 决定 图 像 类 型 。 
对 于 灰 度 图 像 ， 它 返回 一 个 形状 为 (MN) 的 数组， 对 于 彩色 图 像 ， 返 回 形 状 为 M,N,C) 的 数组 。 
其 中 ,M 为 图 像 的 高 度 ,N 为 图 像 的 宽度 , C 为 3 或 4, 表 示 图 像 的 通道 数 。 下 面 的 程序 从 “lenajpg” 
中 读 入 图 像 数据 ， 得 到 的 数组 img 是 一 个 形状 为 (393, 512, 3) 的 单字 节 无 符号 整数 数组 。 这 是 因 
为 通常 使 用 的 图 像 都 是 采用 单字 节 分 别 保存 每 个 像素 的 红 、 绿 、 蓝 三 个 通道 的 分 量 : 


>>> img = plt.imread("lena.jpg") 
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>>> img.shape 
>>X (393, 5327 3) 
>>> img.dtype 
dtype('uint8') 


imshow0 可 以 用 来 显示 imread0 返 回 的 数组 。 如 果 数 组 是 表示 多 通道 图 像 的 三 维 数组 ， 那 
么 每 个 像素 的 颜色 由 各 个 通道 的 值 决 定 : 


>>> plt.imshow(img) # 注意 图 像 是 上 下 颠倒 的 

请 注意 ， 从 JPG 图 像 中 读 入 的 数据 是 上 下 颠倒 的 ， 为 了 正常 显示 图 像 ， 可 以 将 数组 的 第 0 
轴 反 转 ， 或 者 设置 imshow0 的 origin 参数 为 "lower"， 从 而 让 所 显示 图 表 的 原点 在 左下 角 : 

>>> plt.imshow(img[::-1]) # 反 转 图 像 数 组 的 第 9 轴 

>>> plt.imshow(img，origin="lower") # 让 图 表 的 原点 在 左下 角 


如 果 三 维 数组 的 元 素 类 型 为 浮 点 数 ， 那 么 元 素 的 取 值 范围 为 0.0 到 1.0, 与 颜色 值 0 到 255 
对 应 。 超 出 这 个 范围 可 能 会 出 现 颜色 异常 的 像素 。 下 面 的 例子 将 数组 img 转换 为 浮 点 数组 并 用 
imshow0 进 行 显示 : 

>>> img = img[::-1] 

>>> plt.imshow(img*1.6) # 取 值 范围 为 86.9 到 255.9 的 浮 点 数组 ， 不 能 正确 显示 颜色 

>>> plt.imshow(img/255.9) # 取 值 范围 为 9.9 到 1.9 的 浮 点 数组 ， 能 正确 显示 颜色 

>>> plt.imshow(np.clip(img/269.6，6，1)) # 使 用 clip() 限 制 取 值 范围 ， 整 个 图 像 变 亮 


如 果 imshow0 的 参数 是 二 维 数组 , 就 使 用 颜色 映射 表决 定 每 个 像素 的 颜色 。 下 面 显 示 图 像 
中 的 红色 通道 : 


>>> plt.imshow(img[:,:,08]) 


显示 效果 比较 古人， 因为 默认 的 图 像 映射 将 最 小 值 映射 为 蓝 色 、 将 最 大 值 映射 为 红色 。 我 
们 可 以 使 用 colorbar0 将 颜色 映射 表 在 图 表 中 显示 出 来 : 


>>> plt.colorbar() 
通过 imshow0 的 cmap 参数 可 以 修改 显示 图 像 时 所 采用 的 颜色 映射 表 。 颜 色 映射 表 是 一 个 


ColorMap 对 象 ，matplotlib 中 已 经 预先 定义 好 了 很 多 颜色 映射 表 ， 可 以 通过 下 面 的 语句 找到 这 
些 颜色 映射 表 的 名 字 : 


>>> import matplotlib.cm as cm 
>>> cm._cmapnames 
['Spectral', 'copper', 'RdYlGn', 'Set2', 'summer', 'spring', 'gist ncar'’, ...] 


下 面 使 用 名 为 copper 的 颜色 映射 表 显示 图 像 的 红色 通道 ， 很 有 老 照片 的 味道 : 


>>> plt.imshow(img[:,:,8], cmap=cm.copper) 
读者 可 以 运行 下 面 的 程序 快速 查看 上 面 所 有 程序 的 显示 效果 ,如 图 5-17 所 示 ( 见 文 前 彩 插 )。 


5 matplotlib_imshow.py 
启用 imread0O 和 imshow0 显 示 图 像 


图 5-17 用 imread0 和 imshow0 显 示 图 像 


还 可 以 使 用 imshow0 显 示 任 意 的 二 维 数据 , 例如 下 面 的 程序 使 用 图 像 直 观 地 显示 了 二 元 函 
数 f(x,y) =xe”-”， 效 果 如 图 5-18 所 示 ( 见 文 前 彩 插 )。 


. A matplotlib_2dfunc.py 
总 二 使 用 imshowO 可 视 化 二 元 函数 


y, x = np.ogrid[-2:2:266j，-2:2:266j] 
z=x*np.exp( - x**2 - y**2) @ 


extent = [np.min(x), np.max(x), np.min(y), np.max(y)] © 


plt.figure(figsize=(16,3)) 

plt.subplot(121) 

plt.imshow(z, extent=extent, origin="lower") @ 
plt.colorbar() 

plt.subplot(122) 

plt.imshow(z, extent=extent, cmap=cm.gray, origin="lower") 
plt.colorbar() 
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图 5-18 使 用 imshow0 可 视 化 二 元 函数 


@ 首 先 通过 数组 的 广播 功能 计算 出 表示 函数 值 的 二 维 数组 z>， 注 意 它 的 第 0 轴 表 示 Y 轴 、 
第 1 轴 表 示 XX 轴 。@ 然 后 将 义 、Y 轴 的 取 值 范围 保存 到 extent 列表 中 。@ 将 extent 列表 传递 给 
imshow0 的 extent 参数 ， 这 样 一 来 ， 图 表 的 X、Y 轴 的 刻度 标签 将 使 用 extent 列表 所 指定 的 
范围 ( 见 文 前 彩 插 )。 


5.4.6 ”等 值 线 图 


还 可 以 使 用 等 值 线 图 表示 二 元 函数 。 所 谓 等 值 线 ， 是 指 由 函数 值 相等 的 各 点 连 成 的 平滑 曲 
线 。 等 值 线 可 以 直观 地 表示 二 元 函数 值 的 变化 趋势 ， 例 如 等 值 线 密集 的 地 方 表示 函数 值 在 此 处 
的 变化 较 大 。matplotlib 中 可 以 使 用 contour0 和 contourf0 描 绘 等 值 线 , 它们 的 区 别 是 : contourf0 
所 得 到 的 是 带 填充 效果 的 等 值 线 。 下 面 的 程序 演示 了 这 两 个 函数 的 用 法 , 效果 如 图 5-19 所 示 ( 见 
文 前 彩 插 ): 


matplotlib_contour.py 
用 contour 和 contourf 描绘 等 值 线 图 


y，x = np.ogrid[-2:2:266j，-3:3:366j] @ 
二 到 以 本 np2BXP( = M2 = Yee2) 


extent = [np.min(x), np.max(x), np.min(y), np.max(y)] 


plt.figure(figsize=(16,4)) 

plt.subplot(121) 

cs = plt.contour(z, 10, extent=extent) © 
plt.clabel(cs) © 

plt.subplot(122) 

plt.contourf(x.reshape(-1), y.reshape(-1), z, 20) @ 
plt.show() 
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5-19 用 contour( 左 ) 和 contourf( 右 ) 描 绘 等 值 线 图 


@ 为 了 更 清楚 地 区 分 X 轴 和 YY 轴 ， 这 里 让 它们 的 取 值 范围 和 等 分 次 数 均 不 相同 。 这 样 得 
到 的 数组 z 的 形状 为 (200, 300)， 它 的 第 0 轴 对 应 立轴 、 第 1 轴 对 应 义 轴 。 
@ 调 用 contour0 绘 制 数组 z 的 等 值 线 图 , 第 二 个 参数 为 10, 表示 将 整个 函数 的 取 值 范围 等 


分 为 10 个 


区 间 ， 即 显示 的 等 值 线 图 中 将 有 9 条 等 值 线 。 和 imshow0 一 样 ， 可 以 使 用 extent 参 


数 指定 等 值 线 图 的 X 轴 和 立轴 的 数据 范围 。 上 contour0 所 返回 的 是 一 个 QuadContourSet 对 象 ， 
将 它 传递 给 clabel0， 为 其 中 的 等 值 线 标 上 对 应 的 值 。 

@ 调 用 contourf0， 绘 制 将 取 值 范 围 等 分 为 20 份 、 带 填充 效果 的 等 值 线 图 。 这 里 我 们 演示 
了 另外 一 种 设置 X、Y 轴 取 值 范围 的 方法 。 它 的 前 两 个 参数 分 别 是 计算 数组 z 时 所 使 用 的 XX 轴 


和 立轴 上 的 取样 点 ， 这 两 个 数组 必须 是 一 维 的 。 


我 们 还 可 以 使 用 等 值 线 绘制 隐 函 数 曲 线 。 所 谓 隐 函 数 ， 是 指 在 一 个 方程 f(x, y) = 0 中 ， 若 


令 x 在 某 一 


区 间 内 取 任意 值 时 总 有 相应 的 y 满足 此 方程 ， 则 可 以 说 方程 f(x, y) = 0 在 该 区 间 上 


确定 了 x 的 隐 函 数 y， 比 如 隐 函 数 x? + y? -1=0 表 示 一 个 单位 圆 。 


显然 ， 


我 们 无 法 像 绘 制 一 般 函 数 那 样 ， 先 创建 一 个 等 差 数 组 表示 变量 x 的 取 值 点 ， 然 后 计 


算出 数组 中 每 个 x 所 对 应 的 y 值 。 可 以 使 用 等 值 线 解决 这 个 问题 ， 显 然 隐 函数 的 曲线 就 是 值 等 
于 0 的 那 条 等 值 线 。 下 面 的 程序 绘制 函数 f(x,y)=(x* +y 六 -xy 在 f(x,y)=0 和 
je)-01=0 时 的 曲线 ， 效 果 如 图 5-20( 左 ) 所 示 ( 见 文 前 彩 插 )。 


a matplotlib_implicit_func.py 
使 用 等 值 线 绘制 隐 函 数 曲 线 


ye 


np.ogrid[-1.5:1.5:266j，-1.5:1.5:266j] 


fF = (X#*#2 + y**2)*#4 - (X**2 - y**2)**2 


plt.figure(figsize=(9,4)) 
plt.subplot(121) 


extent 


= [np.min(x), np.max(x), np.min(y), np.max(y)] 


cs = plt.contour(f, extent=extent, levels=[8, 86.1], 
colors=["b", "r"], linestyles=["solid", "dashed"], linewidths=[2, 2]) 
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在 调用 contour0 绘 制 等 值 线 时 ， 可 以 通过 levels 参数 指定 所 绘制 等 值 线 对 应 的 函数 值 ， 这 


里 设置 levels 参数 为 [0, 0.1]， 因 此 最 终 将 绘制 两 条 等 值 线 。 通 过 colors、linestyles、linewidths 


等 参数 可 以 分 别 指定 每 条 等 值 线 的 颜色 、 线 型 以 及 线 宽 。 


仔细 观察 图 5-20( 左 ) 会 发 现 ， 表 示 隐 函数 f(x ,?) = 0 蓝 色 实 线 并 不 是 完全 连续 的 ， 在 图 的 


中 间 部 分 它 由 许多 孤立 的 小 段 构成 。 因 为 等 值 线 在 原点 附近 无 限 靠近 ， 因 此 无 论 对 函数 了 的 取 
值 空间 如 何 进行 细 分 ， 总 是 会 有 无 法 分 开 的 地 方 ， 最 终 造成 了 图 中 的 那些 孤立 的 细小 区 域 。 而 
表示 隐 函 数 ,/(x 7-0.1=0 的 红色 虚线 则 是 闭合 且 连 续 的 。 


可 以 通过 contour0 返 回 的 对 象 获得 等 值 线 上 每 点 的 数据 ， 下 面 我 们 在 IPython 中 观察 变量 
它 是 一 个 QuadContourSet 对 象 : 


>>> run matplotlib implicit func.py 
>>> cs 
<matplotlib. contour .QuadContourSet instance at 69x8@A346E96> 


cs 对 象 的 collections 属性 是 一 个 等 值 线 列表 ， 每 条 等 值 线 用 一 个 LineCollection 对 象 表示 : 


>>> cs.collections 
<a list of 2 collections.LineCollection objects> 


每 个 LineCollection 对 象 都 有 它 自己 的 颜色 、 线 型 、 线 宽 等 属性 ， 注 意 这 些 属性 所 获得 的 


结果 外 面 还 有 一 层 封装 ， 要 获得 其 第 0 个 元 素 才 是 真正 的 配置 : 


>>> ce@.get_color()[8] 
DR 人 22 BE 
>>> ce.get_ linewidth()[8] 
2 


由 类 名 可 知 , LineCollection 对 象 是 一 组 曲线 的 集合 , 因此 它 可 以 表示 像 蓝 色 实 线 那样 由 多 


条 线 构成 的 等 值 线 。 它 的 get_paths0 方 法 获得 构成 等 值 线 的 所 有 路 径 ， 本 例 中 蓝 色 实 线 所 表示 
的 等 值 线 由 42 条 路 径 构 成 : 


>>> len(cs.collections[6].get_paths()) 
42 


路 径 是 一 个 Path 对 象 ， 通 过 它 的 vertices 属性 可 以 获得 路 径 上 所 有 点 的 坐标 : 


>>> path = cs.collections[6].get_paths()[6] 
>>> type(path) 
<class “matplotlib.path.Path' > 
>>> path.vertices 
array([[-6.68291457，-6.98938936]， 
[-8.69839269，-6.98743719]， 
[-8.69798995，-6.98513674]， 


ee 
[-8.65276382，-6.99548781]， 
[-6.6678392 ，-6.99273967]， 
[-6.68291457，-6.98938936]]) 


介绍 到 这 里 ， 相 信 读 者 已 经 了 解 如 何 获得 等 值 线 上 每 点 的 数据 了 。 下 面 的 程序 从 等 值 线 集 
合 cs 中 找到 表示 等 值 线 的 路 径 ， 并 使 用 plot0 将 其 绘制 出 来 ， 效 果 如 图 5-20( 右 ) 所 示 ( 见 文 前 
彩 插 )。 


plt.subplot(122) 
for c in cs.collections: 
data = c.get_paths()[6].vertices 
plt.plot(data[:,8], data[:,1], 
color=c.get_color()[6]， linewidth=c.get linewidth()[8]) 


1,% 了 
Id | 1.8| 
月 .5 -1 .5| 
.0 月 -二 
-9 -看 ,5| 
-1, 3,0| 


a . 本 
1 


图 5-20 ”使 用 等 值 线 绘制 隐 函 数 曲线 ( 左 )， 获 取 等 值 线 数据 并 绘图 ( 右 ) 


5.4.7 三 维 绘图 


Impl toolkitsmplot3d 模 块 在 matplotlib 基础 上 提供 了 三 维 绘图 的 功能 。 由 于 它 使 用 matplotlib 
的 二 维 绘图 功能 来 实现 三 维 图 形 的 绘制 工作 ， 因 此 绘图 速度 有 限 ， 不 适合 用 于 大 规模 数据 的 三 
维 绘图 。 如 果 读 者 需要 更 复杂 的 三 维 数据 可 视 化 功能 ， 请 阅读 第 10 章 。 

下 面 是 绘制 三 维 曲面 的 程序 : 


到 matplotlib_surface.py 
使 用 matplotlib 绘制 三 维 曲 面 


import numpy as np 
import mpl toolkits.mplot3d © 
import matplotlib.pyplot as plt 


x, y = np.mgrid[-2:2:26j，-2:2:26j] @ 
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Zu nexp( = Xes2 = y**2) 


ax = plt.subplot(111, projection='3d') © 

ax.plot_surface(x, y, z, rstride=2, cstride=1, cmap = plt.cm.Blues r) @ 
ax.set_xlabel("X") 

ax.set ylabel("Y") 

ax.set_zlabel("Z") 

plt.show() 


程序 的 输出 如 图 5-21 所 示 ( 见 文 前 彩 插 )。 


5-21 使 用 mplot3D 绘制 的 三 维 曲面 


谢 困 否 沐 六 翰 器 一 qholdieuu 


@ 首 先 载 入 mplot3d 模块 ，matplotlib 中 与 三 维 绘图 相关 的 功能 均 在 此 模块 中 定义 。@ 使 用 
mgrid 创建 X-Y 平面 的 网 格 并 计算 网 格 上 每 点 的 高 度 z-。 由 于 绘制 三 维 曲面 的 函数 要 求 X、Y 
和 2Z 轴 的 数据 都 用 相同 形状 的 二 维 数组 表示 , 因此 这 里 不 能 使 用 ogrid 创建 和 之 前 的 imshowO 
不 同 ， 数 组 的 第 0 轴 可 以 表示 X 和 立轴 中 的 任意 一 个 ， 在 本 例 中 第 0 轴 表 示 义 轴 、 第 1 轴 表 
示 立 轴 。 

目 在 当前 图 表 中 创建 一 个 子 图 ， 通 过 projection 参数 指定 子 图 的 投影 模式 为 "3d"， 这 样 
subplot0 将 返回 一 个 用 于 三 维 绘图 的 Axes3D 子 图 对 象 。 


投影 模式 
投影 模式 决定 了 点 从 数据 坐标 转换 为 屏幕 坐标 的 方式 。 可 以 通过 下 面 的 语句 获得 当前 有 
效 的 投影 模式 的 名 称 : 


>>> from matplotlib import projections 

>>> projections.get_projection names() 

['3d', "aitoff'， ‘hammer', 'lambert', "mollweide'， 'polar', 'rectilinear'] 

只 有 在 载 入 mplot3d 模 块 之 后 ,此 列表 中 才 会 出 现 3d 投 影 模式 。'aitoff、hammer" lambert、 
mollweide 等 均 为 地 图 投影 ， polar 为 极 坐标 投影 ，Yectilinear 则 是 默认 的 直线 投影 模式 。 
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@ 调 用 Axes3D 对 象 的 plot_surface0 绘 制 三 维 曲面 。 其 中 : 参数 x、y、z 都 是 形状 为 (20,20) 
的 二 维 数组 , 数组 x 和 y 构成 了 X-Y 平面 上 的 网 格 , 而 数组 z 则 是 网 格 上 各 点 在 曲面 上 的 取 值 。 
通过 cmap 参数 来 指定 值 和 颜色 之 间 的 映射 , 即 曲面 上 各 点 的 高 度 值 与 其 颜色 的 对 应 关系 。 rstride 
和 cstride 参数 分 别 是 数组 的 第 0 轴 和 第 1 轴 的 下 标 间 隔 。 对 于 很 大 的 数组 ， 使 用 较 大 的 间隔 可 
以 提高 曲面 的 绘制 速度 。 程 序 中 ，plot_surface0 调 用 和 下 面 的 语句 是 等 价 的 : 


ax.plot_surface(x[::2,:], y[::2,:], z[::2,:], rstride=1, cstride=1) 


除了 绘制 三 维 曲面 之 外 ，Axes3D 对 象 还 提供 了 许多 其 他 的 三 维 绘图 方法 。 读 者 可 以 通过 
下 面 的 链接 地 址 找到 各 种 三 维 绘图 的 演示 程序 : 


@ http://matplotlib.sourceforge.net/examples/mplot3d/index.html 
matplotlib 的 三 维 绘图 演示 页 面 


刘 国 否 淋 六 得 敬一 -qholdeu 
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Traits 一 一 为 Python 添加 类 型 定义 


Python 作为 一 种 高 级 的 动态 编程 语言 ， 它 的 变量 没有 类 型 ， 这 种 灵活 性 给 快速 开发 带 来 很 
多 便利 ， 不 过 也 不 是 没有 缺点 。 通 过 Traits 库 可 以 为 对 象 的 属性 添加 类 型 校 验 功能 ， 从 而 提高 
程序 的 可 读 性 ， 降 低 出 错 率 。 

Traits 库 是 由 Enthought 公司 开发 的 一 套 开 源 扩展 库 。 虽 然 Traits 库 本 身 和 科学 计算 没有 关 
系 ， 但 它 却 是 该 公司 其 他 各 种 科学 计算 库 的 基础 。 因 此 我 们 将 用 一 整 章 的 篇 幅 对 其 进行 详细 介 
绍 ， 为 读者 学 习 后 续 的 各 种 科学 计算 扩展 库 打 下 基础 。 


6.1 开发 背景 


Traits 库 最 初 是 为 了 开发 交互 式 绘图 库 Chaco 而 设计 的 。 通 常 绘图 库 中 有 很 多 表示 图 形 的 
对 象 ， 每 个 对 象 都 有 很 多 诸如 线 型 、 颜 色 和 字体 之 类 的 属性 。 为 了 方便 用 户 使 用 ， 每 个 属性 可 
以 允许 多 种 形式 的 值 。 例 如 颜色 属性 可 以 是 red'、0xff0000 或 (255, 0, 0)。 也 就 是 说 ， 可 以 用 字 
符 串 、 整 数 或 元 组 等 类 型 的 数据 表示 颜色 。 这 样 的 需求 初 看 起 来 用 Python 的 无 类 型 属性 是 一 个 
很 好 的 选择 ， 因 为 我 们 可 以 把 各 种 各 样 的 值 赋 给 颜色 属性 。 但 是 颜色 属性 虽然 可 以 接受 多 样 的 
值 ， 却 不 是 能 接受 所 有 的 值 ， 比 如 abc 和 0.5 等 等 就 不 能 很 好 地 表示 颜色 。 而 且 虽 然 为 了 方便 
用 户 使 用 ， 对 外 的 接口 可 以 接受 多 种 类 型 的 值 ， 但 是 在 程序 内 部 必须 有 一 个 统一 的 表达 方式 以 
简化 程序 内 部 的 实现 。 用 Trait 属性 可 以 很 好 地 解决 这 样 的 问题 : 

。 它 可 以 接受 能 表示 颜色 的 各 种 类 型 的 值 。 

。 当 给 它 赋值 为 不 能 表达 颜色 的 值 时 ， 它 能 够 立即 捕捉 到 错误 ， 并 且 提 供 一 个 有 用 的 

错误 报告 ， 告 诉 用 户 它 能 够 接受 什么 样 的 值 。 

。 它 提 供 一 个 内 部 的 、 标 准 的 用 于 表示 颜色 的 数据 类 型 。 

下 面 我 们 通过 一 个 简单 的 实例 演示 Trait 属性 的 功能 。 


from enthought.traits.api import HasTraits, Color © 


class Circle(HasTraits): @ 
color = Color © 


@ 首 先 载 入 HasTraits 和 Color， 建 议 读者 在 使 用 Enthought 公司 开发 的 扩展 库 时 ， 采 用 和 
本 例 相 同 的 载 入 方式 。@ 所 有 拥有 Trait 属性 的 类 都 需要 从 HasTraits 继承 。 由 于 Python 支持 多 


继承 ， 因 此 很 容易 将 现 有 的 类 改 为 支持 Trait 属性 。@Color 是 一 个 Trait 类 型 ， 在 Circle 类 中 用 
它 定义 了 一 个 color 属性 。 

熟悉 Python 的 读者 可 能 会 觉得 这 个 程序 有 些 奇怪 : 按照 标准 的 Python 语法 ， 直 接 在 class 
下 定义 的 属性 color 应 该 是 Circle 类 的 属性 .而 程序 的 目的 是 为 Circle 类 的 实例 添加 color 属性 。 
是 不 是 应 该 在 初始 化 方法 _init 0 中 运行 “selfcolor= Color” 呢 ? 答案 是 否定 的 , 请 记 住 : Trait 
属性 可 以 像 类 的 属性 那样 来 定义 ， 像 实例 的 属性 那样 来 使 用 。 我 们 不 管 HasTraits 是 如 何 实现 
这 一 点 的 ， 先 看 看 如 何 使 用 Trait 属性 : 


>>> c = Circle() 

>>> Circle.color #Circle 类 没有 color 属性 

Traceback (most recent call last): 

AttributeError: type object “Circle” has no attribute “color 
>>> c.color 

wx.Colour(255, 255, 255, 255) 


从 上 面 的 运行 结果 可 以 看 出 : Circle 类 没有 color 属性 ， 而 它 的 实例 c 却 拥 有 color 属性 ， 
默认 值 为 白色 “wx.Colour(255, 255, 255, 255)”，wx.Colour 是 wxPython 界面 库 所 使 用 的 颜色 
类 型 。 


>>> c.color = "red" 

>>> c.color 

Wx.Colour(255, 86, 8, 255) 

>>> c.color = 9x66ff66 

>>> c.color 

wx.Colour(8, 255, 89, 255) 

>>> c.color = (0, 255, 255) 

>>> c.color 

wx.Colour(8, 255, 255, 255) 

>>> c.color = 96.5 

[[ 省 略 ]] 

TraitError: The ‘color' trait of a Circle instance must be a string of the form 
(r,g,b) or (r,g,b,a) where r, g, b, and a are integers from 6 to 255, a wx.Colour 
instance, an integer which in hex is of the form OxRRGGBB, where RR is red, GG is 
green, and BB is blue or ‘aquamarine' or 'black’ or 'blue violet' or “blue” or 
"brown' or 'cadet blue' or 'coral' or 'cornflower blue' or 'cyan' or [[ 此 处 略 去 很 
多 英文 颜色 名 ]] or "yellow'，but a value of 8.5 <type 'float'> was specified. 


由 上 面 的 运行 结果 可 知 ， 可 以 将 Ted'、0x00ff00 和 (0, 255, 255) 等 值 赋 给 color 属性 ， 它 们 都 
被 正确 地 转换 为 wx.Colour 类 型 的 值 。 而 当 赋 值 为 0.5 时 ， 会 抛 出 TraitError 异常 ， 并 且 显示 一 
个 很 详细 的 出 错 信息 来 说 明 color 属性 能 支持 的 所 有 值 。 最 后 看 一 个 很 酷 的 功能 : 


>>> c.configure traits() 
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执行 configure_traits0 之 后 ， 出 现 如 图 6-1 所 示 的 对 话 框 以 供 我 们 修改 颜色 属性 ,任意 选择 
一 个 颜色 并 单 击 OK 按钮 ，configure_traits0 返 回 Tme， 而 color 属性 已 经 变 为 我 们 通过 对 话 框 
所 选择 的 颜色 了 : 


>>> c.color 
wx.Colour(64, 34, 117, 255) 


如 果 在 带 “-wthread” 参 数 的 IPython 中 运行 “c.configure_traits0”, 会 立即 返回 False， 
而 不 会 等 待 对 话 框 关 闭 。 


对 于 从 HasTraits 继承 而 来 的 对 象 ， 都 可 以 调用 其 configure_traits0 方 法 以 快速 产生 一 个 设 
置 Trait 属性 的 用 户 界面 。 在 本 例 中， 通过 界面 中 的 颜色 输入 框 可 以 直接 输入 表示 颜色 的 值 ， 或 
者 使 用 按钮 打开 颜色 选择 对 话 框 。 关 于 Traits 库 界 面 方面 的 功能 将 在 下 一 章 详细 介绍 。 


庶 custon 诗 项 打开 颜色 对 话 杠 
图 6-1 自动 生成 的 用 来 修改 颜色 属性 的 对 话 框 


6.2 ”Trait 属性 的 功能 


Traits 库 为 对 象 的 属性 增加 了 类 型 定义 的 功能 ， 此 外 还 提供 了 如 下 的 额外 功能 : 
e 初始 化 : 每 个 Trait 属性 都 有 自己 的 默认 值 。 

。 验证 :Trait 属性 都 有 明确 的 类 型 定义 ， 只 有 满足 定义 的 值 才 能 赋 给 属性 。 
。 代理 : Trait 属性 值 可 以 代理 给 其 他 对 象 的 属性 。 

。 监听 : Trait 属性 值 发 生变 化 时 ， 可 以 运行 事先 指定 的 函数 。 

。 可 视 化 : 拥有 Trait 属性 的 对 象 可 以 很 方便 地 生成 编辑 Trait 属性 的 界面 。 
下 面 的 例子 展示 了 Trait 属性 的 上 述 功 能 。 


a traits_ demo.py 


演示 Trait 属性 的 5 项 功能 


class Parent ( HasTraits ): 
# 初始 化 : last_name 被 初始 化 为 'Zhang* 
last name = Str( 'Zhang’" ) © 


class Child ( HasTraits ): 
age = Int 


# 验证 : father 属性 的 值 必须 是 Parent 类 的 实例 
father = Instance( Parent ) @ 


# 代理 将 Child 对 象 的 1ast_name 属性 代理 给 其 father 属性 的 1ast_name 
last name = Delegate( 'father'’ ) © 


# 监听 : 当 age 属性 的 值 被 修改 时 ， 下 面 的 函数 将 被 运行 
def _age_changed ( self，old，new ): @ 
print "Age changed from %s to %s ' % ( old, new ) 


程序 中 定义 了 Parent 和 Child 这 两 个 从 HasTraits 继承 而 来 的 类 ， 我 们 在 IPython 中 载 入 这 
两 个 类 ， 并 分 别 创建 它们 的 对 象 p 和 c: 


>>> from traits demo import Parent, Child 
>>> p = Parent() 
>>> c = Child() 


@ 用 Str 类 型 定义 Parent 对 象 的 last name 属性 是 一 个 字符 串 ， 并 且 它 的 默认 值 为 Zhang': 


>>> p.last_name 
"Zhang’ 


@ 用 Instance 类 型 定义 Child 对 象 的 father 属性 是 Parent 类 的 实例 , 而 father 属性 的 默认 值 
为 None。 


如 果 Parent 类 在 Child 类 之 后 定义 , 就 可 以 用 字符 串 表 示 类 : father = Instance(Parent)。 


四 通过 Delegate 类 型 ,为 Child 对 象 创建 了 一 个 代理 属性 last_ name。 代 理 功 能 将 使 得 clast_ 
name 和 c.father.last_name 始终 拥有 相同 的 值 。 但 是 由 于 还 没有 设置 对 象 c 的 father 属性 ， 因 此 
无 法 正确 获得 对 象 c 的 last_name 属性 : 


>>> c.last_name 
Traceback (most recent call last): 
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AttributeError: “NoneType” object has no attribute 'last name’ 


设置 了 对 象 c 的 father 属性 之 后 , 就 可 以 正确 获取 它 的 last_ name 属性 了 。 并 且 对 象 c 和 P 

的 last_name 属性 将 始终 保持 一 致 : 

>>> c.father = p 

>>> c.last_ name 

‘Zhang’ 

>>> p.last name = "ZHANG™" 

>>> c.last_name 

+ZHANG' 


@ 当 对 象 的 age 属性 值 发 生变 化 时 ， 将 调用 其 监听 函数 age_changed0: 


>>> c.age = 4 
Age changed from 8 to 4 


最 后 ， 调 用 configure_traits0 显 示 一 个 修改 属性 值 的 对 话 框 ， 如 图 6-2( 左 ) 所 示 : 


>>> c.configure traits() 


6-2 为 Child 对 象 自动 生成 的 属性 修改 对 话 框 ( 左 )、 单 击 Father 按钮 后 弹出 编辑 Parent 对 象 的 对 话 框 ( 右 ) 


从 自动 生成 的 界面 可 以 看 到 ， 属 性 按照 其 英文 名 排序 ， 垂 直 排 为 一 列 。 由 于 father 属性 是 
Parent 类 的 对 象 ， 所 以 界面 中 以 一 个 按钮 表示 它 ， 单 击 此 按钮 将 会 弹出 一 个 如 图 6-2( 右 ) 所 示 的 
对 话 框 ， 可 以 编辑 father 属性 所 对 应 的 对 象 。 

如 果 在 编辑 Father 对 象 的 对 话 框 中 修改 last_name 属性 ，Child 对 象 的 last_name 属性 也 同 
时 被 修改 , 这 是 因为 Child 对 象 的 last_ name 属性 是 一 个 代理 属性 , 值 和 fatherlast_name 始终 保 
持 一 致 。 

还 可 以 调用 print_traits0， 输 出 所 有 的 Trait 属性 名 和 属性 值 : 


>>> c.print_traits() 

age: 4 

father: <_main__.Parent object at 6x13B49126> 
last_name: U'"Zhang 


或 者 调用 get0， 得 到 一 个 描述 对 象 所 有 Trait 属性 的 字典 : 


>>> c.get() 
{'age': 4, 'last name': U' Zhang'， "father': <_main _ .Parent object at 6x13B49126>} 


此 外 还 可 以 调用 set0 来 设置 Trait 属性 的 值 ， 用 set0 可 以 同时 配置 多 个 Trait 属性 : 


>>> c.set(age = 6) 
Age changed from 4 to 6 
<_main_ .Child object at 89x13B494B68> 


在 创建 HasTraits 的 派生 对 象 时 可 以 使 用 关键 字 参 数 设置 各 个 Trait 属性 的 值 ， 例 如 : 
>>> c2 = Child(father=p, age=3) 


当 派 生 类 中 定义 了 _init 0 时 ， 在 其 中 必须 调用 其 父 类 的 _init 0 方法 ， 否 则 Trait 属性 
的 一 些 功 能 将 无 效 。 

也 许 读 者 会 对 Trait 属性 的 工作 原理 感 兴趣 ， 下 面 简单 地 介绍 这 些 功 能 是 如 何 实现 的 。 

首先 Trait 属 性 本 身 和 普通 Python 对象 的 属性 是 一 样 的 .但 是 每 个 Trait 属 性 都 有 一 个 CTrait 
对 象 与 之 对 应 ， 这 个 CTrait 对 象 为 Trait 属性 提供 了 许多 额外 的 功能 。 可 以 通过 trait( 属 性 名 ') 
获得 与 某 个 属性 相对 应 的 CTrait 对 象 ， 或 者 用 traits0 获 得 包含 所 有 CTrait 对 象 的 字典 。 下 面 的 
语句 获得 age 属性 对 应 的 CTrait 对 象 : 


>>> c.trait("age") 
<enthought.traits.traits.CTrait object at 86x2A616A86> 


Trait 属性 的 默认 值 保存 在 与 其 对 应 的 CTrait 对 象 中 : 


>>> p.trait("1ast_name") .default 
"Zhang 


给 Trait 属性 赋值 时 的 验证 工作 由 CTrait 对 象 的 validate0 完 成 。 当 验证 失败 时 抛 出 异常 ， 
验证 成 功 时 则 返回 所 要 赋 的 值 。 因 此 ，validate0 还 可 以 在 对 值 进行 处 理 后 ， 再 赋值 给 属性 。 下 
面 直接 调用 father 属性 所 对 应 CTrait 对 象 的 validate0: 


>>> c.trait("father").validate(c, "father", 2) 

TraitError: The 'father' trait of a Child instance must be a Parent or None， 
but a value of 2 <type 'int'> was specified. 

>>> c.trait("father").validate(c, "father", p) 

<_main__.Parent object at 6x27DB7186> 


当 Trait 属性 值 被 改变 时 ，HasTraits 对 象 的 tait_property_changed0? 会 被 调用 , 在 此 方法 中 


@ tmit property_changed0 在 HasTraits 的 父 类 CHasTraits 中 定义 ，CHasTraits 是 用 C 语言 实现 的 ， 可 以 在 “ctraits.c” 中 找到 它 
的 源 程序 。 
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将 会 调用 用 户 定义 的 属性 监听 函数 。 注 意 ， 它 只 调用 监听 函数 ， 并 不 会 修改 属性 的 值 ， 因 此 下 
面 的 语句 将 调用 age_changed0， 但 不 会 修改 age 属性 的 值 : 


>>> c.trait_ property_changed("age", 8, 10) 
Age changed from 8 to 16 

>>> c.age # age 属性 的 值 没有 发 生变 化 

6 


CTrait 对 象 是 连接 Trait 属性 和 Trait 类 型 的 纽带 , 通过 CTrait 对 象 的 trait_type 属性 可 以 获 
得 定义 Trait 属性 时 所 使 用 的 Trait 类 型 : 


>>> c.trait("age").trait type 

<enthought .traits.trait types.Int object at @x2BD1EFDO> 

>>> c.trait("father").trait type 

<enthought .traits.trait types.Instance object at 69x2BD163D6> 


6.3 ”Trait 类 型 对 象 


在 程序 中 使 用 Trait 属性 需要 按照 下 面 三 个 步 又 进行 : 

(1) 从 enthought.traits.api 中 载 入 所 需要 的 对 象 。 

(2) 创建 Trait 类 型 对 象 。 

(3) 创建 一 个 从 HasTraits 类 继承 的 新 类 , 在 其 中 使 用 所 创建 的 Trait 类 型 对 象 定义 Trait 属性。 

通常 步 又 (2) 和 步骤 (3) 是 放 在 一 起 的 ， 也 就 是 说 ， 在 创建 Trait 类 型 对 象 的 同时 定义 Trait 
属性 ， 本 书 的 大 部 分 例子 都 是 采用 这 种 方式 。 例 如 : 


class Person(HasTraits): 
age = Int(36) 
weight = Float 


上 面 的 程序 为 Person 类 定义 了 两 个 Trait 属性 : age 和 weight。 其 中 : age 属性 使 用 Int 类 
型 对 象 定义 ，30 为 默认 值 ， 而 weight 属性 则 直接 使 用 Float 类 型 定义 ， 实 际 上 它 也 会 创建 一 个 
Float 类 型 对 象 ， 其 具体 实现 在 HasTraits 类 的 内 部 进行 。 在 6.2 节 我 们 介绍 过 ， 每 个 Trait 属性 
都 对 应 一 个 CTrait 对 象 , 而 通过 CTrait 对 象 的 tait type 属性 可 以 获得 Trait 类 型 对 象 。 实际 上 ， 
这 些 CTrait 对 象 和 Trait 类 型 对 象 都 是 在 类 中 保存 的 ， 因 此 对 于 同一 个 HasTraits 派生 类 的 多 个 
实例 ， 它 们 的 某 个 Trait 属性 所 对 应 的 CTrait 对 象 都 是 同一 个 对 象 。 下 面 创建 两 个 Person 类 的 
实例 ， 并 分 别 查看 它们 的 Trait 属性 所 对 应 的 CTrait 对 象 和 Trait 类 型 对 象 ， 通 过 对 象 的 地 址 可 
以 看 出 多 个 实例 之 间 共 享 CTrait 对 象 的 Trait 类 型 对 象 。 


>>> p1 


Person() 


>>> p2 = Person() 

>>> pl1.trait("age") 

<enthought .traits.traits.CTrait object at 6x63218566> 

>>> p2.trait("age") 

<enthought.traits.traits.CTrait object at 9x63218566> 

>>> p1.trait("weight").trait type 

<enthought .traits.trait types.Float object at 9x63319296> 
>>> p2.trait("weight").trait type 

<enthought .traits.trait types.Float object at @x83319290> 


也 可 以 先 单独 创建 一 个 Trait 类 型 对 象 ， 然 后 用 它 定义 多 个 Trait 属性 ， 下 面 是 一 个 例子 : 


pd traits_create type.py 


总 


计生 重用 Trait 类 型 对 象 
from enthought.traits.api import HasTraits，Range 


Coefficient = Range(-1.96，1.6，6.6) 


class Quadratic(HasTraits) : 
C2 = coefficient 
cl 
ce 


coefficient 
coefficient 


程序 中 ，Quadratic 类 有 多 个 类 型 为 Range 的 Trait 属性 ,并且 取 值 范围 都 是 -1.0 到 1.0, 初 
始 值 为 0.0。 为 了 尽量 重用 代码 ， 我 们 先 创建 了 一 个 Range 类 型 对 象 ， 然 后 使 用 它 定 义 了 三 个 
Trait 属性 。 为 了 进行 比较 ， 下 面 的 代码 直接 在 定义 Trait 属性 时 创建 Range 类 型 对 象 : 


class Quadratic2(HasTraits): 
c2 = Range(-1.0, 1.0, 0.0) 
c1 = Range(-1.0, 1.0, 0.0) 
c0 = Range(-1.0, 1.0, 0.0) 


Quadratic 对 象 的 三 个 属性 所 对 应 的 类 型 对 象 都 是 coefficient， 请 注意 比较 Range 类 型 对 象 
的 地 址 : 


>>> run traits_create type.py 

>>> q = Quadratic() 

>>> Coefficient 

<enthought.traits.trait types.Range object at 6x66C27616> 
>>> q.trait("ce").trait type 

<enthought .traits.trait types.Range object at @x86C27610> 


※ 夺 腾 灯 对 疡 UOUMd 半 一 SheJl 


197 


※ 半 肚 状 对 疡 UOUMd 半 一 shlell 


198 


Python 科学 计算 


>>> q.trait("c1").trait type 
<enthought.traits.trait types.Range object at 8x66C27616> 


而 Quadratic2 对 象 的 属性 所 对 应 的 类 型 对 象 是 各 不 相同 的 : 


>>> q2 = Quadratic2() 

>>> q2.trait("c@") .trait_type 
<enthought.traits.trait_types.Range object at 9x66C54C36> 
>>> q2.trait("c1").trait type 

<enthought .traits.trait types.Range object at 9x66C54156> 


6.4 ”Trait 的 元 数据 


Trait 类 型 可 以 拥有 元 数据 属性 ， 这 些 属性 保存 在 与 Trait 属性 对 应 的 CTrait 对 象 中 。 下 面 
以 一 个 实例 解释 什么 是 元 数据 属性 。 


A traits_metatest.py 
人 。 测试 Trait 属性 的 元 数据 


各 


from enthought.traits.api import HasTraits, Int, Str, Array, List 


class MetadataTest(HasTraits): 
i = Int(99, myinfo="test my info") © 
s = Str("test"，1label=u" 字 符 串 ") @ 
# NumPy 的 数组 
a = Array © 
# 元 素 为 Int 的 列表 
list = List(Int) @ 


test = MetadataTest() 
在 IPython 中 运行 上 面 的 程序 之 后 ， 对 test 进行 如 下 操作 : 


>>> test.traits() 

{'i': <enthought.traits.traits.CTrait object at 6x85D44EA6>， 

's': 《enthought.traits.traits.CTrait object at 9x65D44EF8>， 
"trait_added ' : <enthought.traits.traits.CTrait object at 9x66F96818>， 
'trait_ modified': <enthought.traits.traits.CTrait object at @x86F9867C@>, 
[[ 省 略 ]]} 

>>> test.trait("i") 

<enthought.traits.traits.CTrait object at 6x85D44EA6> 


通过 调用 HasTraits 对 象 的 taits0, 可 以 得 到 一 个 包含 其 中 所 有 CTrait 对 象 的 字典 2”。CTrait 
对 象 用 于 描述 Trait 属性 ， 例 如 test.trait(i") 描 述 testi、testtrait(s) 描 述 test.s。 

每 个 Trait 属性 都 有 一 个 与 之 对 应 的 CTrait 对 象 用 于 描述 它 。 所 谓 元 数据 属性 ， 就 是 描述 
Trait 属性 的 属性 ， 它 们 保存 在 CTrait 对 象 中 。 元 数据 属性 可 以 分 为 三 类 : 


内 部 属性 : 这 些 属性 是 CTrait 对 象 自 带 的 ， 只 读 不 能 写 。 
识别 属性 : 这些 属 性 可 以 自由 设置 ， 它 们 可 以 改变 Trait 属性 的 一 些 行为 。 
用 户 属性 : 用 户 自己 添加 的 属性 ， 需 要 自己 编写 程序 使 用 它们 。 


下 面 是 一 些 内 部 元 数据 属性 ， 可 以 读 取 它们 的 值 ， 但 不 能 修改 : 


array: 是 否 是 数组 ， 不 是 数组 的 Trait 属性 没有 此 属性 。 

default: Trait 属性 的 默认 值 。 

default kind: 一 个 描述 默认 值 类 型 的 字符 串 ， 可 以 是 "value"、"list"、"dict"、"self`、 
"factory"、"method" 等 。 

trait_type: 定义 Trait 属性 时 使 用 的 Trait 类 型 对 象 。 

inner traits: 内 部 的 CTrait 对 象 ， 在 List、Dict 等 中 使 用 ， 用 来 描述 List 和 Dict 的 内 
部 元 素 。 

type: Trait 属性 的 分 类 ， 可 以 是 "constant"、"delegate"、"event"、"property"、"trait"。 


下 面 的 元 数据 属性 不 是 预定 义 的 ， 但 是 可 以 被 HasTraits 对 象 使 用 : 


desc: 描述 Trait 属性 用 的 字符 串 ， 在 生成 界面 时 使 用 它 作为 所 创建 的 编辑 器 的 帮助 
信息 。 

editor: 指定 在 界面 中 编辑 Trait 属性 时 所 使 用 的 编辑 器 类 型 。 

label: 界面 中 Trait 属性 编辑 器 的 标签 字符 串 。 

rich_compare: 指定 判断 Trait 属性 值 发 生变 化 的 方式 。 默 认 值 为 Tme， 表 示 按 值 比 
较 ，False 表示 按照 对 象 地 址 比较 。 

trait_value: 指定 Trait 属性 是 否 接受 TraitValue 类 的 对 象 ， 默 认 值 为 False。 为 Tme 
时 ， 将 Trait 属性 设置 为 TraitValue0，Trait 属性 重 置 为 默认 值 。 

transient: 指定 当 对 象 被 保存 (持久 化 ) 时 是 否 保存 此 Trait 属性 值 ， 当 此 属性 不 存在 时 
使 用 默认 值 True。 


下 面 查看 一 下 上 一 实例 中 ，test 对 象 的 各 个 Trait 属性 的 元 数据 属性 。 
@ 在 创建 定义 属性 i 的 Int 类 型 对 象 时 ， 设 置 其 默认 值 为 99， 并 设置 了 一 个 名 为 myinfo 的 
用 户 元 数据 属性 。 这 些 信息 都 保存 在 与 1 属性 对 应 的 CTrait 对 象 中 : 


>>> test.trait("i").default 


9 


>>> test.trait("i").myinfo 
"test my info' 
>>> test.trait("i").trait type 


@ test 对象 有 两 个 额外 的 CTrait 对 象 : trait_added 和 trait_modified， 它 们 在 HasTraits 类 中 定义 。 
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<enthought.traits.trait types.Int object at 6x65DBD2D6> 


@ 属 性 s 的 默认 值 为 "test"， 并 且 它 有 一 个 识别 元 数据 属性 的 label。 在 生成 界面 时 ,使 用 它 
作为 编辑 器 的 标签 。 为 了 在 界面 中 使 用 中 文 ， 需 要 使 用 Unicode 字符 串 。 


>>> test.trait("s").label 
字符 串 
>>> test.configure _traits() # 显示 界面 ， 注 意 观察 名 为 “字符 串 ”的 标签 


人 @Array 类 型 用 于 定义 值 为 NumpPy 数组 的 Trait 属性 ， 因 此 属性 a 的 元 数据 属性 array 为 


True: 


>>> test.trait("a").array 
True 


@ 属 性 list 是 一 个 元 素 类 型 为 整数 的 列表 。 通 过 inner traits 元 数据 属性 可 以 获得 与 列表 元 
素 对 应 的 CTrait 属性 : 


>>> test.trait("list") 

<enthought.traits.traits.CTrait object at 9x633FCF56> 

>>> test.trait("1ist").trait_type 

<enthought.traits.trait types.List object at 9x91B92B36> 

>>> test.trait("list").inner_traits # list 属性 内 部 元 素 所 对 应 的 CTrait 对 象 
(<enthought.traits.traits.CTrait object at 6x67665348>，) 

>>> test.trait("list").inner_traits[6].trait_type # 内 部 元 素 所 对 应 的 Trait 类 型 对 象 
<enthought.traits.trait_types.Int object at 8x86FF5716> 


6.$S ”预定 义 的 Trait 类 型 


Traits 库 为 Python 的 许多 数据 类 型 提供 了 预定 义 的 Trait 类 型 。 对 于 Python 的 每 个 简单 数 
据 类 型 来 说 ， 都 有 两 种 Trait 类 型 与 之 对 应 : 

e 强制 Trait 类 型 : 当 强 制 类 型 的 Trait 属性 被 赋值 为 类 型 不 匹配 的 数据 时 , 会 抛 出 异常 。 

e 自动 Trait 类 型 : 类 型 不 匹配 时 会 自动 调用 此 类 型 对 应 的 转换 函数 进行 类 型 转换 。 

表 6-1 对 这 两 种 Trait 类 型 进 了 总 结 。 


表 6-1_ 强制 Trait 类 型 与 自动 Trait 类 型 的 比较 


强制 类 型 自动 类 型 自动 转换 函数 


Bool CBool bool0 


Complex CComplex j complexO 


( 续 表 ) 


自动 转换 函数 
Hoat0 


下 面 的 例子 比较 这 两 种 类 型 : 


from enthought.traits.api import HasTraits, CFloat, Float 


class Person(HasTraits): 
cweight = CFloat(56.6) 
weight = Float(56.6) 


程序 中 用 自动 Trait 类 型 CFloat 定义 了 一 个 cweight 属性 ， 它 可 以 接收 能 转换 为 数值 的 字 
符 串 "90"， 而 weight 属性 则 使 用 强制 Trait 类 型 Float 定义 ， 将 它 赋 值 为 "90" 会 抛 出 异常 : 


>>> p = Person() 
>>> p.cweight = “98"” 
>>> p.cweight 

96.6 

>>> p.weight = “96” 
TraitError [[ 省 略 ]] 


可 以 想象 CFloat 的 内 部 处 理 过 程 : 它 先 将 传 入 的 值 用 内 部 函数 float0 进 行 类 型 转换 ， 然 后 
再 把 结果 赋值 给 Trait 属性 。 

除了 简单 类 型 以 外 ，Traits 库 还 定义 了 许多 其 他 的 常用 数据 类 型 。 下 面 列 出 了 一 些 常用 的 
预定 义 Trait 类 型 : 

e Any: 任何 对 象 。 


Any( [value = None, **metadata] ) 

e Aray: Numpy 的 数组 。 

Array( [dtype = None, shape = None, value = None, typecode = None, **metadata] ) 
。 Button: 按钮 类 型 ， 通 常用 于 触发 事件 ， 参 数 用 于 描述 界面 中 按钮 的 样式 。 


Button( [label ="", image = None, style = "button", orientation = "vertical”", 
width_padding = 7, height padding = 5, **metadata] ) 
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e@ Callable: 可 调用 对 象 。 
Callable( [value = None, **metadata] ) 


e@ CArray: 可 自动 转换 类 型 的 NumPy 数组 ， 参 数 和 Array 相同 。 
e@ Class: Python 老式 类 的 对 象 。 


Class( [value, **metadata] ) 


。 Code: 某 种 编程 语言 的 字符 串 。 


Code( [value = "", minlen = 86，maxlen = sys.maxint, regex = "", **metadata] ) 


e Color: 界面 库 中 所 采用 的 颜色 对 象 。 


Color( [*args, **+metadata] ) 

e CSet: 自动 转换 类 型 的 集合 对 象 。 

CSet( [trait = None，value = None, items = True，*#metadata] ) 
e Constant: 常量 对 象 ， 值 不 能 改变 ， 必 须 指定 初始 值 。 


Constant( value*[, ***metadata] ) 


e Dict: 字典 对 象 ， 为 了 方便 使 用 ， 在 Traits 库 中 还 预先 定义 了 一 些 键 的 类 型 为 字符 串 
的 字典 类 型 ， 例 如 DictStrAny、DictSttBool 等 。 


Dict([key_trait = None, value trait = None, value = None, items = True, **metadata]) 


se Directory: 表示 某 个 目录 的 路 径 的 字符 串 。 


Directory( [value =""，auto_set = False, entries = 16，exists = False, **metadata] ) 


se Fither: 多 个 Trait 类 型 的 复合 ， 例 如 Either(Str, Float) 表 示 定 义 的 属性 可 以 是 字符 串 
或 浮 点 数 。 


Either( vall*[, *val2, ..., valN, **metadata] ) 


se Enum: 枚 举 数据 ， 值 可 以 是 候选 值 中 的 任意 一 个 。 


Enum( values*[, ***metadata] ) 


e Event: 触发 事件 用 的 对 象 。 


Event( [trait = None, **metadata] ) 


e Expression: Python 的 表达 式 对 象 。 
Expression( [value ="8"，*#*#metadata] ) 
。 File: 表示 文件 路 径 的 字符 串 。 


File( [value = "", filter = None，auto_set = False, entries = 16，exists = False, 
**metadata ] ) 


e Font: 界面 库 中 表示 字体 的 对 象 。 
Font( [*args, **metadata] ) 


读者 可 以 查看 各 个 Trait 类 型 的 文档 以 了 解 其 具体 用 法 。 下 面 以 枚 举 类 型 为 例 ， 介 绍 Trait 
类 型 的 使 用 方法 。 使 用 Enum 可 以 定义 枚 举 类 型 ， 在 Enum 的 定义 中 给 出 所 有 的 候选 值 ， 这 些 
值 必须 是 Python 的 简单 数据 类 型 , 例如 字符 串 、 整 数 、 浮 点 数 等 等 , 候选 值 的 类 型 可 以 不 一 样 。 
可 以 直接 将 候选 值 作 为 参数 ， 也 可 以 将 其 放 在 列表 中 ， 第 一 个 值 为 默认 值 : 


class Items(HasTraits): 
count = Enum(None, 6, 1, 2, 3, "many") 
# 或 者 : 
# count = Enum([None, 0, 1, 2, 3, "many"]) 


下 面 是 运行 结果 : 


>>> item = Items() 

>>> item.count = 2 

>>> item.count = "many" 

>>> item.count = 5 

Traceback (most recent call last): [[ 省 略 ]] 


如 果 和 希望 候选 值 是 动态 的 ， 可 以 用 values 参数 指定 候选 值 所 对 应 的 属性 名 : 


class Items(HasTraits): 
count_list = List([None, 06, 1, 2, 3, "many"]) 
count = Enum(values="count_ list") 


在 上 面 的 Items 类 中 , 首先 用 List 定义 了 一 个 列表 类 型 的 count_list 属性 ， 并 为 其 指定 了 默 
认 值 .然后 在 用 Enum 定义 枚 举 类 型 的 属性 时 , 使 用 values 参数 指定 枚 举 属性 的 候选 值 为 count_ 
list 属性 中 的 元 素 。 


>>> item = Items() 
>>> item.count = 5 
Traceback (most recent call last) 


[[ 略 去 错误 提示 ， 此 错误 提示 无 法 显示 候选 值 列 表 ]] 


※ 闪 腾 尊 对 小 LOMAd 斗 一 se 


关 装 肌 状 车 济 UOUMd 斗 一 -SHEeJL 


204 


Python 科学 计算 


>>> item.count list.append(5) 

>>> item.count = 5 # 由 于 候选 值 列 表 中 有 5， 因 此 赋值 成 功 
>>> item.count 

5 


在 上 面 的 例子 中 , 因为 5 不 在 count list 属性 中 ,所 以 第 一 次 将 count 属性 赋值 为 5 时 会 抛 
出 异常 。 当 将 5 添加 到 count list 属性 中 之 后 ， 就 可 以 将 count 属性 设置 为 5 了 。 


6.6 ”Property 属性 


在 标准 的 Python 语法 中 , 可 以 使 用 property0 为 类 创建 Property 属性 。Property 属性 的 用 法 
和 一 般 属性 相同 ， 但 是 在 获取 它 的 值 或 者 给 它 赋值 时 会 调用 相应 的 方法 。Traits 库 也 提供 了 类 
似 的 功能 ， 但 是 其 用 法 比 标准 Python 的 简单 。 我 们 先 看 一 个 例子 : 


je traits propertypy 
让 ”演示 Property 类 型 


from enthought.traits.api import HasTraits, Float, Property, cached_property 


class Rectangle(HasTraits): 
width = Float(1.6) 
height = Float(2.9) 


#area 是 一 个 属性 ， 当 width、height 的 值 发 生变 化 时 ， 对 应 的 _get_area 函数 将 被 调用 
area = Property(depends_on=[ "width', "height']) © 
# 通过 cached_property 修饰 器 缓存 _get_area( ) 的 输出 
@cached property ©@ 
def get area(self): © 
"area 的 get 函数 ， 注 意 此 函数 名 和 对 应 Property 属性 名 的 关系 " 
print “recalculating” 
return self.width * self.height 


上 在 Rectangle 类 中 , 使 用 Property0 定 义 了 一 个 area 属性 .Traits 库 的 Property 类 型 和 Python 
的 不 同 , 它 根据 属性 名 直接 决定 属性 所 对 应 的 方法 。 当 读 取 area 属性 值 时 , 得 到 的 是 日 _get_area0) 
的 返回 值 ， 而 当 设置 area 属性 时 ， 所 设置 的 值 将 传递 给 _set_area0。 由 于 在 本 例 中 没有 定义 
_set_area0， 因 此 area 属性 是 只 读 的 。 此 外 ， 通 过 depends_on 参数 可 以 指定 Property 属性 的 依 
赖 关 系 。 本 例 中 ， 当 Rectangle 对 象 的 width 和 height 属性 值 发 生变 化 时 ， 需 要 重新 计算 area 
属性 。 

@_get_area0 用 @cached_property 进行 修饰 ， 这 样 _get_area0 的 返回 值 将 被 缓存 ， 除 非 area 
属性 所 依赖 的 width 和 height 属性 值 发 生变 化 ， 否 则 将 一 直 使 用 缓存 值 ， 而 不 会 每 次 都 调用 


_get_area0。 下 面 看 看 实际 的 运行 效果 : 


>>> from traits_property import Rectangle 

>>> r = Rectangle() 

>>> r.area # 第 一 次 取得 area 时 ， 需 要 进行 计算 
recalculating 

2.0 

>>> r.width = 16 

>>> r.area # 修改 width 之 后 ， 取 得 area， 也 需要 进行 计算 
recalculating 

26.6 

>>> r.area # width 和 height 都 没有 发 生变 化 ， 因 此 直接 返回 缓存 值 ， 没 有 重新 计算 
26.6 


我 们 看 到 : 通过 depends_on 和 (人 @cached property， 系 统 可 以 跟踪 area 属性 的 状态 ， 判 断 是 
否 需 要 调用 _get_area0 以 重新 计算 area 属性 值 。 注 意 : 在 运行 “rwidth=10” 之 后 ， 并 没有 立即 
调用 _get_area0， 它 只 是 保存 一 个 需要 重新 计算 的 标志 ， 等 到 真正 需要 获取 area 的 值 时 ， 
_get_area0 才 会 被 调用 。 

如 果 显 示 出 编辑 对 象 z 的 界面 , 就 可 以 看 到 属性 依赖 关系 的 强大 之 处 。 为 了 更 加 有 趣 一 些 ， 
这 里 连续 调用 两 次 edit_traits0， 弹 出 图 6-3 所 示 的 两 个 编辑 界面 : 


>>> r.edit traits() 
<enthought.traits.ui.ui.UI object at 89x62FCD426> 
>>> r.edit traits() 
<enthought.traits.ui.ui.UI object at 89x62FD68A6> 


个 这 里 使 用 edit_traits0 生 成 界面 ， 它 和 configure traits0 的 区 别 将 在 下 一 章 介绍 。 


-= 有 过 


| 
图 6-3 ”修改 两 个 对 话 框 中 的 Height 或 Width 属性 都 会 重新 计算 Area， 并 同时 更 新 对 话 框 显示 


修改 任意 一 个 界面 中 的 width 或 height 属性 , 在 输入 数值 的 同时 , 两 个 界面 中 的 Area、Height 
和 Width 文本 框 中 的 值 将 同时 更 新 , 每 次 键盘 按键 都 会 调用 _get_area0。 此 时 在 IPython 窗口 中 
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直接 修改 width 的 值 ， 也 会 调用 _get_area0): 


>>> r.width = 25 
recalculating 


打开 界面 之 后 ， 界 面 对 象 开 始 监听 对 象 z 的 各 个 属性 ， 因 此 当 我 们 修改 rwidth 之 后 ， 系 统 
设置 rarea 的 标志 为 需要 重新 计算 , 然后 发 现 有 对 象 在 监听 rarea 的 值 , 因此 直接 调用 _get_area0 
更 新 其 值 ， 并 通知 所 有 的 监听 对 象 ， 因 此 界面 就 一 齐 更 新 了 。 每 个 界面 都 会 在 Trait 属性 所 对 
应 的 CTrait 对 象 中 添加 监听 对 象 : 


>>> t = r.trait("area") # 获 得 与 area 属性 对 应 的 CTrait 对 象 
>>> t._notifiers(True) # _notifiers 方法 返回 所 有 的 通知 对 象 ， 当 aera 属性 改变 时 ， 这 些 对 象 将 
被 通知 
[<enthought.traits.trait_notifiers.FastUITraitChangeNotifywrapper instance at ...>， 
<enthought.traits.trait_notifiers.FastUITraitChangeNotifywWrapper instance at ...>] 


由 于 弹出 了 两 个 界面 ， 因 此 有 两 个 需要 通知 的 对 象 。 如 果 再 运行 一 次 redit_traits0， 这 个 
列表 将 有 3 个 元 素 。 


6.7 Trait 属性 监听 


HasTraits 对 象 的 所 有 Trait 属性 都 自动 支持 监听 功能 。 当 某 个 Trait 属性 的 值 发 生变 化 时 ， 
HasTraits 对 象 会 通知 所 有 监听 此 属性 的 函数 。 监 听 函 数 分 为 静态 和 动态 两 种 ， 下 面 的 程序 演示 
了 这 两 种 监听 方式 : 


更 traits_listener.py 
演示 Trait 属性 的 监听 功能 


from enthought.traits.api import HasTraits, Str, Int 


class Child ( HasTraits ): 


name = Str 
age = Int 
doing = Str 


def _str_ (self): 
return "%s<%x>" % (self.name, id(self)) 


# 当 age 属性 的 值 被 修改 时 ， 下 面 的 函数 将 被 运行 
def _age_changed ( self，old，new ): © 
print "%s.age changed: form %s to %s" % (self, old, new) 


def _anytrait_changed(self，name，old，new): © 
print "anytrait changed: %s.%s from %s to %s" % (self, name, old, new) 


def log trait changed(obj, name, old, new): © 
print "log: %s.%s changed from %s to %s" % (obj, name, old, new) 


计 _name == "_main_ 
h = Child(name = "HaiYue", age=4) 
k = Child(name = "KaiYu", age=1) 
h.on trait_ change(log trait_ changed, name="doing") @ 


@ 当 Child 对 象 的 age 属性 值 发 生变 化 时 ， 对 应 的 静态 监听 函数 _age_changed0 将 被 调用 。 
@_anytrait_changed0 是 一 个 特殊 的 静态 监听 函数 ， 任 何 Trait 属性 的 值 发 生变 化 都 会 调用 此 函数 。 

@ 通 过 调用 h.on_trait_change0， 动 态 地 将 @ 普 通 函 数 log trait changed0 和 对 象 h 的 doing 
属性 联系 起 来 。 当 doing 属性 改变 时 ，log_trait_changed0 将 被 调用 。 动 态 监 听 函 数 也 可 以 是 某 
个 对 象 的 方法 。 

在 IPython 中 运行 下 面 的 语句 ， 观 察 各 个 属性 监听 函数 的 调用 情况 : 


>>> run traits listener.py 

anytrait changed: <261ba86>.age from 6 to 4 
<261ba86>.age changed: form 8 to 4 

anytrait changed: HaiYue<261ba86> .name from to HaiYue 
anytrait changed: <261bae6>.age from 6 to 1 

<261bae6> .age changed: form 8 to 1 

anytrait changed: KaiYu<261bae6>.name from to KaiYu 


然后 分 别 改变 h 和 的 属性 : 


>>> h.age = 5 

anytrait changed: HaiYue<5d87e76> .age from 4 to 5 
HaiYue<5d87e76>.age changed: form 4 to 5 

>>> h.doing =“sleeping” 

anytrait changed: HaiYue<5d87e76> .doing from to sleeping 
log: HaiYue<5d87e76>.doing changed from to sleeping 

>>> k.doing = "playing" 

anytrait changed: KaiYu<5d874e@>.doing from to playing 


child 监听 印 数 按照 顾 序 被 调用 
Meng 静态 监听 函数 
Tratt 国 性 ; age _amytrsts_changed 动 志 监 昕 1 | 动 志 监 折 2 
going _aBe_changed 


图 64 Trait 属性 的 监听 函数 的 调用 顺序 
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6-4 显示 了 各 种 监听 函数 的 调用 顺序 。 静 态 监听 函数 的 参数 有 如 下 几 种 形式 : 


_age_changed(self) 
_age_changed(self，new) 
_age_changed(self，old，new) 
_age_changed(self, name, old, new) 


动态 监听 函数 的 参数 有 如 下 几 种 : 


observer() 

observer(new) 

observer(name, new) 
observer(obj, name, new) 
observer(obj, name, old, new) 


其 中 : obj 是 拥有 Trait 属性 的 对 象 ，name 为 值 发 生变 化 的 属性 名 ，old 为 改变 之 前 的 值 ， 
new 为 改变 之 后 的 值 。 

当 多 个 Trait 属性 都 需要 使 用 同一 个 监听 函数 时 , 可 以 使 用 @on_trait_change 对 监听 函数 进 
行 修饰 : 


@on_trait_change( names ) 
def any_method_name( self，...): 


当 names 所 描述 的 Trait 属性 发 生 改变 时 ， 将 调用 any_method_name0，hnames 是 一 个 字符 
串 或 列表 ， 它 能 够 很 灵活 地 描述 一 组 Trait 属性 。 下 面 列举 了 一 些 常 用 的 属性 匹配 语法 ， 当 与 
之 匹配 的 属性 发 生变 化 时 将 调用 被 修饰 的 监听 函数 : 
e 用 逗号 隔 开 多 个 属性 名 : '\foo,bar ， 当 selffoo 或 selfbar 改变 时 。 
用 列表 描述 多 个 属性 名 : [foovbar]， 功 能 同上 。 
描述 嵌 套 的 属性 名 : '\foobar， 当 selffoo.bar 或 self foo 改变 时 。 
描述 嵌 套 的 属性 名 : 'foo:bar ， 当 selffoo.bar 改变 时 。 
列表 属性 : 'foo[]，selffoo 是 一 个 列表 ， 当 它 本 身 或 者 它 的 元 素 改变 时 。 
指定 属性 名 开头 字符 串 : 'foo+'， 当 以 foo 开头 的 属性 改变 时 。 
指定 元 数据 : '+foo， 有 名 为 foo 元 数据 的 属性 改变 时 。 
完整 的 匹配 方法 请 参考 Traits 库 的 用 户 手册 。 下 面 的 程序 演示 了 多 种 属性 的 匹配 语法 : 


- # Traits extended name.py 
守 _ 演 示 属 性 名 的 匹配 


from enthought.traits.api import * 


class HasName(HasTraits) : 
name = Str() 


def _str_(self): 
return "<%s %s>" % (self._class_._name _，self.name) 


class Inner(HasName): 
x = Int 
y= Int 


class Demo(HasName): 
x = Int 
y = Int 
z = Int(monitor=1) # 有 元 数据 属性 monitor 的 Int 
inner = Instance(Inner) 
alist = List(Int) 
test1 = Str() 
test2 = Str() 


def inner default(self): 
return Inner(name="inner1") 


@on_trait_change("x,y,inner. [x,y],test+,+monitor,alist[]") 
def event(self, obj, name, old, new): 
print obj, name, old, new 


d = Demo(name="demo") 
下 面 是 各 种 属性 值 改变 时 的 运行 结果 : 


>>> d.x = 16 # 与 x 匹配 

<Demo demo> x 8 10 

>>> d.y = 26 # 与 y 匹 配 

<Demo demo> y 8 26 

>>> d.inner.x = 1# 与 inner.[x,y] 匹 配 

<Inner innerl> x 8 1 

>>> d.inner.y = 2 # 与 inner.[x,y] 匹 配 

<Inner innerl> y 8 2 

>>> d.inner = Inner(name="inner2") # 与 inner.[x,y] 匹 配 
<Demo demo> inner <Inner inner1> <Inner inner2> 
>>> d.test1 = “ok”# 与 test+ 匹 配 

<Demo demo> test1 ok 

>>> d.test2 = "hello” # 与 test+ 匹 配 

<Demo demo> test2 hello 
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>>> d.z = 38 # 与 tmonitor 匹配 

<Demo demo> z 8 36 

>>> d.alist = [3] # 与 alist[] 匹 配 

<Demo demo> alist [] [3] 

>>> d.alist.extend([4,5]) # 与 alist[] 匹 配 
<Demo demo> alist items [] [4, 5] 

>>> d.alist[2] = 18 # 与 alist[] 匹 配 
<Demo demo> alist items [5] [16] 


6.8 Event 和 Button 属性 


Event 和 Button 是 两 个 专门 用 以 处 理事 件 的 Trait 类 型 ，Button 从 Event 继承 ， 它 除了 具备 
Event 的 事件 处 理 功能 之 外 ， 还 可 以 通过 TraitsUI 库 自 动 生成 界面 中 的 按钮 控件 。Event 属性 和 
其 他 的 Trait 属性 有 如 下 区 别 : 

。 当 任 何 值 赋值 给 Event 属性 时 都 将 触发 与 其 绑 定 的 属性 监听 事件 ， 而 通常 的 Trait 属 

性 只 有 在 其 值 发 生 改变 时 才 触 发 事件 。 

e Event 属性 不 存储 属性 值 ， 因 此 对 其 赋值 只 是 起 到 触发 事件 的 作用 ， 而 所 赋 的 值 将 被 
忽略 。 试 图 获取 Event 属性 值 将 抛 出 异常 。 由 于 Event 属性 所 触发 的 事件 不 表示 某 个 
属性 值 的 变化 ， 因 此 它们 所 对 应 的 静态 监听 函数 名 为 _event fired ， 而 不 是 
_event_changed， 下 面 是 使 用 Event 属性 的 例子 : 


有 办 traits_event.py 
半球 使 用 Event 属性 


class Point(HasTraits): © 
x = Float(6.6) 
y = Float(9.6) 
updated = Event 


@on trait_change( "x,y”) 
def pos_changed(self): © 
self.updated = True 


def updated fired(self): © 
self.redraw() 


def redraw(self): @ 
print "redraw at %s, %s" % (self.x, self.y) 


@ 在 Point 类 中 定义 了 x、y 和 updated 三 个 Trait 属性 。@ 使 用 @on trait_change 对 pos_ 


changed0 方 法 进行 修饰 , 当 x 或 属性 被 修改 时 pos_changed0 会 被 调用 .这 里 是 通过 设置 updated 
属性 来 触发 updated 事件 。@ 在 updated 的 事件 处 理 方法 updated fired0 中 调用 redraw0 重 新 绘 
制 ， 下 面 是 修改 各 种 属性 值 时 的 事件 触发 情况 : 


>>> from traits event import * 

>>> p = Point() 

>>> p.Xx=1 

redraw at 1.6，6.9 

>>> p.y = 1 

redraw at 1.96，1.9 

>>> p.x = 1 # 由 于 x 的 值 已 经 为 1， 因 此 不 触发 事件 
>>> p.updated = True 

redraw at 1.96，1.9 

>>> p.updated = 8 # 给 updated 赋予 任何 值 都 会 触发 事件 
redraw at 1.96，1.9 


6.9 ”Trait 属 性 的 从 属 关系 


代理 功能 是 Trait 属性 的 一 个 高 级 特性 ， 它 能 够 在 不 同 的 对 象 的 Trait 属性 之 间 建 立 从 属 关 
系 。 类 的 继承 关系 通常 描述 的 是 对 象 之 间 “ 是 ”(is-a) 的 关系 ， 而 从 属 关系 描述 对 象 之 间 的 包含 
关系 ， 即 “有 ”(has-a) 的 关系 。 
在 Traits 库 中 可 以 建立 两 种 从 属 关系 : 代理 (delegation) 和 原型 (prototyping)。 
e 代理 :在 两 个 属性 之 间 建 立 的 代理 关系 ， 能 确保 这 两 个 属性 值 始 终 保持 一 致 ， 修 改 
任何 一 个 属性 的 值 都 将 同时 修改 另外 一 个 属性 的 值 。 
。 原型 ， 和 代理 类 似 ， 但 是 在 派生 属性 的 值 被 直接 修改 之 后 ， 两 个 属性 的 值 不 再 保持 
一 致 ， 但 它们 仍然 使 用 相同 的 校 验方 式 。 
下 面 用 一 个 例子 说 明代 理 类 型 和 原型 类 型 的 功能 : 


. traits_delegate_intro.py 
守 。 演示 代理 和 原型 类 型 


class Point(HasTraits): 
x= Int 
y= Int 


class Circle(HasTraits): 
center = Instance(Point) 上 
x = DelegatesTo("center") © 


闪 半 须 关 车 济 uoMd 半 一 一 Shell 


211 


关 计 有 山 状 车 济 uogAd 半 一 shlell 


212 


Python 科学 计算 


y = PrototypedFrom("center") © 
r= Int 

p= Point() 

c = Circle() 

c.center = p 


程序 中 定义 了 两 个 类 一 Point 和 Circle。@Circle 对 象 的 center 属性 是 一 个 Point 对 象 ， 
四 四 属性 x 和 y 分 别 使 用 代理 类 型 DelegatesTo 和 原型 类 型 PrototypedFrom 定义 ， 我 们 称 这 两 
个 属性 为 代理 属性 。 它 们 都 代理 给 了 center 属性 ， 我 们 称 center 属性 为 代理 对 象 。 如 果 c 是 一 
个 Circle 对象， 那么 可 以 通过 cx 访问 c.center.x。 

下 面 是 Trait 库 中 关于 代理 类 型 的 定义 : 


class DelegatesTo(delegate，prefix=”'，1istenable=True，*##metadata) 


DelegatesTo 的 第 一 个 参数 是 一 个 字符 串 ， 它 是 拥有 此 代理 属性 的 对 象 的 某 个 属性 名 。 当 
以 下 三 种 情况 发 生 时 ， 代 理 属 性 的 值 将 会 被 改变 : 

e 代理 对 象 对 应 的 属性 值 改变 时 ， 即 当 c.center.x 改变 时 ，cx 会 同时 被 改变 。 

e 代理 对 象 本 身 改 变 时 ， 即 当 c.center 改变 时 ，c.x 和 c.y 都 会 同时 被 改变 。 

。 直接 修改 代理 属性 时 ,代理 对 象 对 应 的 属性 值 也 将 被 改变 ， 即 可 以 通过 修改 cx 来 改 

变 ccenterx。 

PrototypedFrom 和 DelegatesTo 类 似 ， 但 是 当 c.y 被 直接 修改 之 后 ，c.y 和 c.center.y 的 值 将 

不 再 保持 一 致 。 下 面 用 前 面 的 例子 演示 代理 类 型 和 原型 类 型 的 功能 以 及 它们 的 区 别 : 


>>> p.x = 19 # 修 改 代理 对 象 ， 代 理 属性 会 同时 改变 

>>> cx 

16 

>>> p.y = 169 # 修 改 代理 对 象 ， 原 型 属性 会 同时 改变 

>>> cy 

166 

>>> c.x = 26 。  # 修 改 代理 属性 ， 代 理 对 象 会 同时 改变 

>>> p.x 

26 

>>> c.y = 266 # 由 于 c.y 是 一 个 原型 属性 ， 因 此 不 会 改变 p.y 
>>> p.y 

166 

>>> p.y = 366 # 再 次 修改 p.y， 由 于 关联 已 经 断 开 ， 因 此 c.y 不 会 改变 
>>> c.y 

266 


当 prefix 参数 为 空 字符 串 时 ， 表 示 代 理 所 涉及 的 两 个 属性 名 相同 。 如 果 prefix 是 一 个 合 ; 
的 变量 名 ， 它 将 作为 代理 对 象 的 属性 名 使 用 ， 此 外 还 可 以 使 用 星 号 指定 前 组 。listenable 参数 为 


True， 表 示 代 理 属性 能 够 响应 前 两 种 情况 的 属性 值 改变 事件 。 下 面 再 看 一 个 例子 : 


traits_delegate .py 
守卫 用 DelegatesTo 建立 代理 关系 


class System(HasTraits) : 
name = Str 


class CPU(HasTraits) : 
cpu_type = Str 


class PC(HasTraits): 
os = Instance(System) 
cpu = Instance(CPU) 


cpu_type = DelegatesTo("cpu") © 
os_name = DelegatesTo("os"，prefix="name") © 


def os name_changed(self): 
print "OS changed to"，self.os_name 


程序 中 ，PC 类 有 两 个 代理 属性 ，@ 其 中 cpu_type 属性 的 代理 对 象 是 cpu， 由 于 没有 指定 
prefix 参数 ,因此 代理 属性 PC.cpu_type 和 PC.cpu.cpu_type 对应。@ 而 os_name 属性 则 通过 prefix 
参数 指定 它 对 应 的 代理 对 象 的 属性 名 ， 即 PC.os_name 和 PC.os.name 对 应 。 


>>> os = System(name="WindowsXP") 

>>> cpu = CPU(cpu_type="Atom286") 

>>> pc = PC(os=os，cpu=cpu) 

>>> pc.cpu_type # 和 pc.cpu.cpu_type 相同 

"Atom28@" 

>>> pc.0s_name # 和 pc.os.name 相同 

"WindowsXP" 

>>> os.name = "Windows7”# 修改 被 代理 的 属性 ， 触 发 代理 属性 的 监听 函数 
0S changed to Windows7 


6.10 ”动态 添加 Trait 属性 


前 面 介绍 的 都 是 在 类 的 定义 中 声明 Trait 属性 ， 在 类 的 对 象 中 使 用 Trait 属性 。 由 于 Python 
是 动态 语言 ， 因 此 Traits 库 提供 了 直接 为 某 个 特定 的 对 象 添加 Trait 属性 的 方法 。 

在 下 面 的 例子 中 ， 直 接生 成 一 个 HasTraits 类 的 实例 a， 然 后 调用 其 add_trait0 方 法 动态 地 
为 a 添加 一 个 名 为 x 的 Trait 属性 ， 类 型 为 Float， 初 始 值 为 3.0: 
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>>> from enthought.traits.api import * 
>>> a = HasTraits() 

>>> a.add trait("x", Float(3.0)) 

>>> a.x 

3.9 


接 下 来 再 创建 一 个 HasTraits 类 的 实例 b, 用 add_trait0 为 b 添加 一 个 属性 a, 指定 其 类 型 为 
HasTraits 类 的 实例 。 然 后 把 实例 a 赋值 给 实例 b 的 属性 a: 


>>> b = HasTraits() 
>>> b.add trait("a", Instance(HasTraits)) 
>>> b.a = a 


然后 为 实例 b 添加 一 个 类 型 为 Delegate 的 属性 y， 在 by 和 b.ax 之 间 建 立 代 理 连 接 。 
modify=True 表示 可 以 通过 by 修改 b.ax 的 值 。 我 们 看 到 ， 当 by 的 值 改 为 10 时 ，a.x 的 值 也 
同时 改变 了 : 


>>> b.add trait("y", Delegate("a", "x", modify=True)) 
>>> b.y 

3.9 

>>> b.y = 16 

>>> a.X 

16.9 


实际 上 ， 通 过 赋值 语句 为 HasTraits 对 象 添 加 新 属性 时 ， 这 些 属 性 都 是 Trait 属性 ， 只 不 过 
它们 的 类 型 为 Python， 因 此 它们 能 够 接收 任何 类 型 的 对 象 ， 起 不 到 校 验 的 作用 : 


>>> class A(HasTraits): 


pass 
>>> a = A() 
>>> a.x=3 


>>> a.y = "string" 

>>> a.traits() 

人 {.…… 省 略 ... 

"x': <enthought.traits.traits.CTrait object at 89x61B4C666>， 
'y': <enthought.traits.traits.CTrait object at 8x61B4C666>} 
>>> a.trait("x").trait type 

<enthought .traits.trait types.Python object at 6x81AF5B96> 
>>> a.configure_traits() # 显示 编辑 对 象 a 的 界面 


上 面 的 程序 将 显示 一 个 界面 ， 可 以 编辑 对 象 a 的 属性 x 和 y， 通 过 控件 修改 属性 值 之 后 ， 
我 们 会 发 现 它们 都 变 成 了 unicode 类 型 。 


6.11 创建 自己 的 Trait 类 型 


除了 使 用 预定 义 的 Trait 类 型 之 外 ， 还 可 以 使 用 下 面 三 种 方法 创建 新 的 Trait 类 型 ; 
e 从 TraitType 类 继承 

e 使 用 Trait0 

e 定义 TraitHandler 类 


6.11.1 从 TraitType 继承 


几乎 所 有 预定 义 的 Trait 类 型 都 从 TraitType 类 继承 ， 可 以 通过 继承 TraitType 或 预定 义 的 
Trait 类 型 来 创建 新 的 Trait 类 型 。 下 面 的 程序 演示 了 如 何 使 用 继承 创建 新 的 Trait 类 型 : 


a traits_oddint.py 
自 定义 奇数 Trait 类 型 


from enthought.traits.api import BaseInt 
class OddInt( BaseInt ): © 


# 定义 默认 值 
default value =1@ 


# trait 类 型 的 描述 文字 
info text = “an odd integer’ 


def validate( self, object, name, value ): © 
" 校 验 值 是 否 为 奇数 " 
value = super(OddInt, self).validate(object, name, value) @ 
if (value % 2) == 
return value 


self.error( object, name, value ) 


@Oddmt 类 定义 了 一 个 奇数 Trait 类 型 ， 它 从 BaseInt 而 不 是 从 Int 继承 。Int 和 BaseInt 完 
全 相同 ,但 是 为 了 提高 运算 速度 , mt 在 C 语言 级 别 进行 校 验 , 它 不 会 运行 Python 级 别 的 validate0 
方法 。 因 此 为 了 进行 是 否 是 奇数 的 校 验 ， 需 要 从 BaseInt 继承 。 

@ 在 OddInt 类 中 定义 了 两 个 属性 一 一 default_value 和 info_text, 它们 覆盖 了 BaseInt 中 的 值 。 
请 注意 OddInt 的 基 类 中 没有 HasTraits， 因 此 这 里 定义 的 是 类 属性 而 不 是 Trait 属性 。 

人 @OddInt 作为 BaseInt 的 派生 类 ， 可 以 重用 或 修改 BaseInt 中 定义 的 各 种 方法 。 在 OddInt 
的 validate0 中 ，@ 首 先 通过 super0 调 用 BaseInt 的 validate0， 判 断 value 是 否 是 整数 ， 然 后 再 判 
断 value 是 否 是 奇数 。 下 面 测 试 OddInt 的 奇数 校 验 效果 : 
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>>> class A(HasTraits): 
v = 0ddInt 
>>> a = A() 
>>> a.Vv 
法 
>>> avV=3 
>>> av = 2 
Traceback (most recent call last): 
TraitError: The 'v' trait of an A instance must be an odd integer, but ... 


在 TraitType 的 派生 类 中 还 可 以 定义 post_setattr0 方 法 ， 此 方法 在 设置 object 的 name 属性 
为 value 之 后 被 调用 : 


post_setattr( self, object, name, value ) 


如 果 在 派生 类 中 定义 了 get0 或 set0, 那么 此 Trait 类 型 就 变 成 了 Property 属性 类 型 , validateO0 
将 不 再 起 作用 。get0 的 参数 为 : 


get( self, object, name ) 
set0 的 参数 为 : 


set( self, object, name, value ) 


当 读 取 某 对 象 的 Property 属性 时 ， 将 调用 与 之 对 应 的 Property 属性 类 型 的 get0 方 法 。 对 
Property 属性 赋值 时 , 则 调用 Property 属性 类 型 的 set0 方 法 。 下 面 的 程序 演示 了 如 何 创建 Property 
属性 类 型 ; 


a traits property typepy 
创建 Property 属性 类 型 


from enthought .traits.api import TraitType, HasTraits, Float 


class ScaledValue(TraitType): 
def init(self): © 
self.value = 9 


def get(self, object, name): 
print "get %s.%s" % (object, name) 
return self.value * object.scale @ 


def set(self, object, name, value): 
print "set %s.%s = %s" % (object, name , value) 


self.value = value © 


class A(HasTraits): 


scale = Float(1.6) 
tl = Scaledvalue @ 


在 ScaledValue 类 中 定义 了 get0 和 set0 方 法 ， 因 此 它 是 一 个 Property 属性 类 型 。@ 在 init0 
中 初始 化 value 属性 为 0，init0 在 TraitType 的 _init_0) 的 最 后 被 调用 。@@ 在 get0 中 ， 返 回 的 是 
Property 属性 对 象 自己 的 value 属性 和 拥有 此 Property 属性 的 对 象 的 scale 属性 的 乘积 。@ 设 置 
Proerty 属性 时 将 调用 set0， 从 而 设置 其 value 属性 为 指定 的 值 。 


由 于 ScaledValue 是 Traits 类 型 , 多 个 A 对 象 的 tl 属性 将 公用 同一 个 Traits 类 型 对 象 ， 
因此 不 能 用 此 方法 为 每 个 对 象 的 t1 属性 保存 不 同 的 value 值 。 


@A 类 中 的 属性 tl 是 ScaledValue 类 型 ， 因 此 它 的 值 将 由 给 属性 tl 设置 的 值 和 scale 属性 
的 值 决定 。 在 下 面 的 程序 中 ， 为 对 象 a 的 属性 赋值 : 属性 t1 赋值 为 2， 属 性 scale 赋值 为 3。 
此 最 终 获得 的 属性 t1 的 值 为 它们 的 乘积 6: 


>>> a = A() 

>>> atl = 2 

set <_ main_.A object at 6x276B6786> .tl = 2 
>>> a.t1 

get <_main__.A object at 6x276B6786> .tl 


2.9 


>>> a.scale = 3 


>>> a.t1 
get <_main__.A object at 6x276B6789> .tl1 


6.6 


6.11.2 使 用 Trait() 
使 用 Trait0 可 以 快速 定义 新 的 Trait 类 型 ， 它 的 参数 列表 非常 灵活 ， 具 体 用 法 请 参考 用 户 


手册 或 Trait0 的 帮助 文档 。 下 面 介绍 几 种 常见 的 用 法 : 


Trait(1.0): 第 一 个 参数 指定 默认 值 ， 类 型 由 默认 值 的 类 型 决定 ， 相 当 于 Float(1.0)。 
Trait(0, 1, 2, "many"): 枚 举 类 型 ， 第 一 个 参数 0 为 默认 值 。 

Trait([0, 1, 2, "many"]): 也 可 以 用 列表 定义 枚 举 类 型 。 

Trait(MyClass): 值 必须 是 MyClass 或 其 子 类 的 对 象 ， 默 认 值 为 None， 但 不 能 被 赋值 
为 None。 

Trait(None, MyClass): 同上 ， 但 可 以 赋值 为 None。 
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e ”Trait(obj): 值 必须 是 MyClass 或 其 子 类 的 对 象 ， 默 认 值 为 obj( 假 设 obj 是 MyClass 的 
对 象 )。 
当 参 数 中 有 一 个 或 多 个 字典 对 象 时 ， 定 义 的 是 一 个 映射 类 型 ， 映 射 类 型 会 为 对 象 创建 两 个 
属性 : 
。 值 为 字典 中 某 个 键 值 的 正常 属性 。 
e 名 为 正常 属性 名 加 下 划 线 的 影子 属性 ， 值 为 正常 属性 在 字典 中 对 应 的 值 。 
下 面 的 例子 定义 了 一 个 描述 颜色 的 映射 类 型 : 


# 使 用 字典 定义 一 个 映射 类 型 
black_color = Trait("black", 
{f"black" :9x666666，"white":9xffffff，“"red" :9xff6666}) 


# 定义 一 个 默认 值 为 "red "的 映射 类 型 


red_color = Trait("red"，black_color) 


class Shape(HasTraits): 
line_color = black_color 
fill color = red_color 


Shape 类 有 两 个 属性 : line_color 和 fil_color。 因 为 它们 都 是 映射 类 型 的 属性 ， 所 以 Shape 
对 象 还 有 两 个 影子 属性 : line_color 和 fill color 。 当 line_color 或 旨 L_color 改变 时 ， 对 应 的 影 
子 属性 的 值 将 自动 根据 定义 类 型 的 字典 进行 设置 : 


>>> s = Shape() 

>>> s.line_color 

"black’ 

>>> s.line_ color_ 

8 

>>> s.fill_color 

"red’ 

>>> hex(s.fill color ) 
“8xff6666 

>>> s.fill_color =“white” 
>>> hex(s.fill_color ) 
RE 

>>> s.fill_color = 8 # 对 影子 属性 赋值 并 不 能 改变 其 对 应 的 正常 属性 值 
>>> s.fill color 

"white" 


在 自己 的 类 型 中 使 用 影子 属性 
影子 属性 可 以 在 TraitType 类 的 post_setattr0 中 进行 赋值 ， 例 如 下 面 的 程序 将 属性 值 的 两 
倍 赋值 给 影子 属性 : 


class T(TraitType) : 
def post_setattr( self, object, name, value ): 
object._dict_ [ name +'_"]=value*2 


6.11.3 ”定义 TraitHandler 类 


我 们 还 可 以 将 一 个 TraitHandler 对 象 传递 给 Trait0， 为 Trait 类 型 提供 校 验 功能 。 当 对 某 个 
Trait 属性 赋值 时 ， 如 果 与 此 属性 对 应 的 Trait 类 型 对 象 拥有 一 个 TraitHandler 对 象 ， 将 调用 此 
TraitHandler 对 象 的 validate0 方 法 对 所 赋 的 值 进行 校 验 ， 并 且 将 validate0 的 返回 值 赋值 给 Trait 
属性 。 下 面 的 程序 演示 了 TraitHandler 的 使 用 方法 : 


from enthought.traits.api import TraitHandler，HasTraits，Trait 


class TraitEvenInteger(TraitHandler): 
def validate(self, object, name, value): 
if type(value) is int and value > @: 
return value - value % 2 
self.error(object, name, value) 


def info(self): 
return 'a positive even integer' 


class B(HasTraits): 
v= Trait(1, TraitEvenInteger()) 


TraitEvenInteger 从 TraitHandler 继承 ，validate0 对 值 进行 校 验 ，info0 返 回 一 个 描述 用 的 字 
符 串 。 当 value 为 整数 并 且 大 于 0 时 ，validate0 返 回 小 于 等 于 value 的 最 大 偶数 ， 否 则 它 抛 出 
TraitError 异常 。 


>>> b.v=3 
>>> b.v 

本 

>>> b.v=8 
>>> b.v 

8 

>>> b.v = -5 


TraitError: The 'v' trait of a B instance must be a positive even integer, 
but a value of -5 <type 'int'> was specified. 


Traits 库 中 预定 义 了 一 些 比 较 实 用 的 TraitHandler 派生 类 。 例 如 ，TraitPrefixList 接受 所 指 
定 的 字符 串 列表 或 字符 串 的 唯一 前 级 ， 赋 值 给 Trait 属性 的 值 是 与 前 缀 匹配 的 完整 字符 串 : 


>>> class Foo(HasTraits): 
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es n = Trait("one", TraitprefixList(["one", "two","three"])) 
>>> f = Foo() 

>>> f.n = "th" 

>>> f.n 
"three” 
0 
>>> f.n 


one 
FREE 

TraitError: The 'n' trait of a Foo instance must be ‘one' or ‘two' or "three" 
(or any unique prefix), but a value of 't' <type 'str'> was specified. 


请 读者 参考 Traits 库 的 目录 下 的 “trait handlerspy” 文 件 ， 了 解 更 多 的 TraitHandler 派生 类 
及 其 用 法 。 
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Python 有 着 丰富 的 界面 开发 库 ， 除 了 默认 安装 的 Tkinter 以 外 ，wxPython、pyQt 等 都 是 
非常 优秀 的 界面 开发 库 。 但 是 它们 有 一 个 共同 的 问题 : 需要 开发 者 掌握 众多 的 API 函数 ， 许 多 
细节 需要 开发 者 自己 进行 配置 ， 例 如 控件 的 属性 、 位 置 以 及 事件 响应 ， 等 等 。 

在 开发 科学 计算 程序 时 ,我 们 希望 快速 实现 一 个 够 用 的 界面 ， 让 用 户 能 够 交互 式 地 处 理 数 
据 ， 而 又 不 希望 在 界面 制作 上 花费 过 多 的 精力 。 以 Traits 库 为 基础 、 以 MVC 模式 为 设计 思想 
的 TraitsUI 库 就 是 实现 这 一 理想 的 最 佳 方案 。 


MVC 模式 

MVC 的 英文 全 称 为 Model-View-Controller, 它 的 目的 是 实现 一 种 动态 的 程序 设计 , 简化 
程序 的 修改 和 扩展 工作 ， 并 且 使 程序 的 各 个 部 分 能 够 充分 地 被 重复 利用 。 

Model( 模 型 ): 程序 中 存储 数据 以 及 对 数据 进行 处 理 的 部 分 。 

View( 视 图 ): 程序 的 界面 部 分 ， 实 现 数据 的 显示 。 

Controller( 控 制 器 ): 起 到 视图 和 模型 之 间 的 组 织 作 用 ， 控 制程 序 的 流程 ， 例 如 将 界面 的 
操作 转换 为 对 模型 的 处 理 。 


7.1 默认 界面 


TraitsUT 库 是 一 套 建立 在 Traits 库 基 础 之 上 的 用 户 界面 库 。 它 和 Traits 库 紧 密 相连 , 如 果 读 
者 已 经 设计 好 了 一 个 从 HasTraits 继承 而 来 的 类 ， 那 么 直接 调用 其 configure_traits0 方 法 ， 系 统 
将 会 使 用 TraitsUI 库 自 动 生成 对 话 框 界 面 ， 以 供用 户 交互 式 地 修改 对 象 的 Trait 属性 。 下 面 是 一 
个 简单 的 例子 : 


5 # traitsUI default_view.py 
守卫 编辑 HasTraits 对 象 的 对 话 框 


from enthought.traits.api import HasTraits, Str, Int 


class Employee(HasTraits): 
name = Str 
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department = Str 
salary = Int 
bonus = Int 


Employee().configure traits() 


此 程序 创建 一 个 Employee 类 ， 然 后 调用 configure_traits0 显 示 出 如 图 7-1( 左 ) 所 示 的 默认 
界面 。 

在 此 自动 生成 的 界面 中 ， 所 有 的 属性 都 采用 文本 框 进行 编辑 ， 并 且 每 个 文本 框 前 面 都 有 一 
个 文字 标签 ， 上 面 的 文字 根据 Trait 属性 名 自动 生成 : 第 一 个 字母 变 为 大 写 ， 所 有 的 下 划 线 变 
为 空格 。 对 话 框 的 最 下 面 提供 了 OK 和 Cancel 按钮 以 便 确 定 或 取消 对 Trait 属性 的 修改 。 

由 于 salary 属性 定义 为 Int 类 型 ， 因 此 当 输 入 不 能 转换 为 整数 的 字符 串 时 ， 输 入 框 将 以 红 
色 背 景 提醒 输入 错误 ， 并 且 OK 按钮 变 成 无 效 ， 如 图 7-1( 右 ) 所 示 。 


图 7-1 自动 生成 的 Employee 类 的 对 话 框 ( 左 )、 提 醒 非法 的 输入 数据 并 且 使 OK 按钮 无 效 ( 右 ) 


没有 写 一 行 与 界面 相关 的 代码 , 就 能 得 到 一 个 已 经 够 实用 的 界面 , 应 该 还 是 很 令 人 满意 的 。 
如 果 想 手 工控 制 界面 的 设计 和 布局 ， 就 需要 添加 自己 的 代码 了 。 


7.2 用 View 定义 界面 


HasTraits 的 派生 类 用 Trait 属性 保存 数据 ， 它 相当 于 MVC 模式 中 的 模型 (Model)。 当 没有 
指定 界面 的 显示 方式 时 ，Traits 库 会 自动 创建 一 个 默认 的 界面 。 我 们 可 以 通过 视图 (View) 对 象 
为 模型 设计 更 加 实用 的 界面 。 


7.2.1 外 部 视图 和 内 部 视图 
下 面 是 用 视图 对 象 定义 界面 的 完整 程序 ， 图 7-2 显示 的 是 界面 截图 。 


7 traitsUI simple view.py 
二 使 用 视图 对 象 描述 界面 


from enthought.traits.api import HasTraits, Str, Int 
from enthought.traits.ui.api import View, Item © 


class Employee(HasTraits): 


name = Str 
department = Str 
salary = Int 
bonus = Int 
view = View( © 
Item('department" ，label=u" 部 门 "，tooltip=u" 在 哪个 部 门 干 活 "),，@ 
Item('name' ，label=u" 姓 名 ")， 
Item('salary'，label=u" 工 资 ")， 
Item( 'bonus' ，1abel=u" 奖 金 ")， 
title = 山 " 员 工资 料 "，width=256，height=156，resizable=True @ 
» 
if _name_ == "_ main_": 


p = Employee() 
p.configure traits() 


此 程序 在 模型 类 Employee 的 基础 之 上 ， 添 加 了 与 界面 显 
示 相 关 的 代码 。@@ 界 面相 关 的 内 容 都 位 于 TraitsUI 库 中 ， 这 里 
从 中 载 入 View 和 Item。View 是 描述 界面 的 视图 类 ，Item 是 描 
述 界 面 中 的 控件 和 模型 对 象 的 Trait 属性 之 间 关 系 的 类 。 

@ 在 Employee 类 中 创建 了 一 个 View 对 象 ， 为 Employee 
类 的 每 个 Trait 属性 创建 对 应 的 Item 对 象 。 上 创建 多 个 Item 对 
象 ， 并 作为 参数 传递 给 View0O。Item 对 象 是 视图 的 基本 组 成 单 
位 ， 每 个 Item 对 象 描述 界面 中 的 一 个 编辑 器 ， 这 些 编辑 器 用 于 编辑 模型 对 象 中 对 应 的 Trait 属 
性 的 值 。 界面 中 的 编辑 器 按照 Item 对 象 传递 给 View0 的 先后 顺序 显示 , 而 不 再 按照 Traits 属性 
名 排序 。Item 对 象 有 许多 参数 ， 它 们 对 Item 对 象 的 内 容 、 表 现 以 及 行为 进行 描述 。 第 一 个 参 
数 指定 与 编辑 器 对 应 的 Trait 属性 名 ，label 和 tooltip 参数 设置 编辑 器 的 标签 和 提示 文本 。Item 
对 象 还 有 很 多 其 他 属性 ， 请 读者 参考 TraitsUI 的 用 户 手册 ， 或 者 在 Python 中 输入 “Ttem??” 直 
接 查 看 其 源 代码 。 下 面 是 Item 类 的 部 分 源 程序 ，Item 类 从 HasTraits 继承 ， 因 此 它 的 属性 都 是 
Trait 属性 : 


图 7-2 使 用 视图 对 象 描述 界面 


class Item ( ViewSubElement ): 
""™ An element in a Traits-based user interface. 


# Trait definitions: 


# A unique identifier for the item. If not set, it defaults to the value 
# Of **name**. 
id = Str 


# User interface label for the item in the GUI. If this attribute is not 
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# set, the label is the value of **name** with slight modifications: 

# underscores are replaced by spaces, and the first letter is capitalized. 
# If an item's **name** is not specified, its label is displayed as 

# static text, without any editor widget. 

label = Str 


# Name of the trait the item is editing: 
name = Str 


除了 Item 之 外 ，TraitsUI 模块 还 定义 了 Item 的 几 个 派生 类 : Label、Heading 和 Spring。 它 
们 只 用 于 辅助 界面 布局 ， 因 此 不 需要 和 模型 对 象 的 Trait 属性 关联 。 

@View 类 也 从 HasTraits 继承 , 可 以 直接 在 创建 View 对 象 时 , 通过 关键 字 参 数 设置 其 Trait 
属性 。title 属性 为 窗口 标题 栏 中 的 文字 ，width 和 height 属性 为 窗口 的 大 小 ，resizable 属性 为 
True 表示 窗口 的 大 小 可 变 。 

同一 个 模型 对 象 可 以 通过 多 个 视图 对 象 用 不 同 的 界面 显示 ， 下 面 看 一 个 例子 : 


a traitsUI views.py 


使 用 多 个 视图 对 象 


from enthought.traits.api import HasTraits, Str, Int 
from enthought.traits.ui.api import View, Group, Item © 


g1 = [Item('department'，1label=u" 部 门 "，tooltip=u" 在 哪个 部 门 干 活 ")，@ 


Item( 'name' ，label=u" 姓 名 ")] 


g2 = [Item('salary'，label=u" 工 资 ")， 


Item('bonus' ，label=u" 奖 金 ")] 


class Employee(HasTraits): 


name = Str 
department = Str 
salary = Int 
bonus = Int 


traits view = View( © 
Group(*g1，1label = u' 个 人 信息 '，show_border = True)， 
Group(*g2，label = u' 收 入 '，show_border = True)， 
title = u" 缺 省 内 部 视图 ") 


another_view = View( @ 
Group(*g1，1label = u' 个 人 信息 '，show_border = True)， 
Group(*g2，label = u' 收 入 '，show_border = True)， 
title = u" 另 一 个 内 部 视图 ") 


global _ view = View( © 


Group(*g1，1label = u' 个 人 信息 '，show_border = True)， 
Group(*g2，label = u' 收 入 '，show_border = True)， 
title = u" 外 部 视图 ") 

p = Employee() 


# 使 用 内 部 视图 traits_view 
p.edit_traits() @ 


# 使 用 内 部 视图 another_view 


p.edit traits(view="another view") @ 


# 使 用 外 部 视图 viewl 
p.configure_traits(view=global view) © 


@ 从 TraitsUI 库 载 入 Group 类 ， 用 Group 对 象 可 以 对 界面 中 的 编辑 器 进行 分 组 。 为 了 使 后 
续 定 义 视图 对 象 的 程序 更 加 简洁 , @ 程 序 中 定义 了 两 个 全 局 列表 gl 和 g2, 它们 的 元 素 都 是 Iem 
对 象 。@@ 在 Employee 类 的 内 部 用 View0 定 义 了 两 个 视图 对 象 : traits_view 和 another view。 
而 @ 定 义 了 一 个 全 局 的 视图 对 象 ，global_view。 在 定义 视图 对 象 时 ， 用 Group 对 用 于 定义 界面 
上 编辑 器 的 Item 对 象 进行 分 组 。 

值得 注意 的 是 ，Employee 类 中 定义 的 两 个 视图 对 象 既 不 是 类 的 属性 ， 也 不 是 实例 的 属性 。 
这 些 内 部 视图 对 象 会 放 到 Employee 类 的 _view_traits_ 属性 中 。_view_traits_ 属性 是 一 个 
ViewElements 对 象 ， 它 的 content 属性 是 保存 所 有 内 部 视图 的 字典 : 


>>> run traitsUI views.py 
>>> Employee._view traits__.content.keys() 
['another_view', 'traits_ view'] 


@ 当 调用 edit_traits0 显 示 界面 时 ， 默 认 使 用 在 模型 类 内 部 定义 的 默认 视图 对 象 traits_view 
生成 界面 。@ 使 用 view 参数 可 以 指定 显示 界面 时 所 使 用 的 内 部 视图 对 象 的 名 称 。@ 也 可 以 直接 
将 视图 对 象 传递 给 view 参数 ， 这 样 可 以 使 用 在 模型 类 外 定义 的 视图 对 象 生成 界面 。 图 7-3 显示 
了 用 三 种 视图 对 象 生成 的 界面 。 


图 7-3 使 用 外 部 视图 和 内 部 视图 定义 界面 的 显示 


edit_ traits0 和 configure_traits() 一 样 ， 也 被 用 于 生成 界面 ， 它 们 的 区 别 在 于 : edit_traits0 显 
示 界 面 之 后 不 进入 后 台 界面 库 的 消息 循环 ， 因 此 如 果 直 接 运 行 只 调用 edit_traits0 的 程序 ， 界 面 
将 在 显示 之 后 立即 关闭 ， 程 序 的 运行 也 随 之 结束 。 而 对 于 configure_traits0， 将 进入 消息 循环 ， 
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直到 用 户 关闭 所 有 窗口 。 因 此 通常 情况 下 ， 主 界面 窗口 或 模 态 对 话 框 ?使 用 configure_traits0 显 
示 ， 而 无 模 态 窗口 或 对 话 框 则 使 用 edit_traits0 显 示 。 


选择 后 台 界 面 库 

用 TraitsUI 库 创建 的 界面 可 以 选择 后 台 界 面 库 , 目前 支持 的 有 qt4 和 wx 两 种 。 在 启动 程 
序 时 添加 “-toolkit qt4” 或 “-toolkit wx” 可 选择 使 用 何 种 界面 库 生 成 界面 。 本 书 全 部 使 用 wx 
作为 后 台 界 面 库 。 


在 本 小 节 的 例子 中 ，Employee 类 用 于 保存 数据 ， 因 此 它 属 于 MVC 模式 中 的 模型 (Mode])， 
而 View 对 象 定义 了 Employee 的 界面 显示 部 分 ， 它 属于 视图 (View)。 通 过 将 视图 对 象 传递 给 模 
型 对 象 的 configure_traits0 方 法 ， 将 模型 对 象 和 视图 对 象 联系 起 来 。 在 用 来 定义 编辑 器 的 Tem 对 
象 中 ， 不 直接 引用 模型 对 象 的 属性 ， 而 是 通过 属性 名 和 模型 对 象 进行 联系 。 这 样 一 来 ， 模 型 和 
视图 之 间 的 耦合 性 很 弱 , 只 需要 属性 名 匹配 , 同一 个 视图 对 象 可 以 运用 到 不 同 的 模型 对 象 之 上 。 

有 时候 我 们 希望 模型 类 知道 如 何 显示 它 自己 , 这 时 可 以 在 模型 类 的 内 部 定义 视图 。 在 模型 
类 中 定义 的 视图 可 以 被 其 派生 类 继承 ， 因 此 派生 类 能 使 用 父 类 的 视图 。 在 调用 configure traitsO0) 
时 如 果 不 设置 view 参数 ， 将 使 用 模型 对 象 内 部 的 默认 视图 对 象 生成 界面 。 如 果 在 模型 类 中 定 
义 了 多 个 视图 对 象 ， 默 认 使 用 名 为 raits_view 的 视图 对 象 。 


7.2.2 ”多 模型 视图 


在 上 一 小 节 的 例子 中 ， 一 个 模型 可 以 对 应 多 个 视图 。 同 样 ， 使 用 一 个 视图 可 以 将 多 个 模型 
对 象 的 数据 显示 在 一 个 界面 窗口 中 。 下 面 是 用 一 个 视图 对 象 同时 显示 多 个 模型 对 象 的 例子 。 程 
序 的 运行 界面 如 图 7-4 所 示 。 


萤 


之 


A traitsUI multi models.py 


7-4 用 一 个 视图 对 象 同时 显示 多 个 模型 对 象 


对 于 前 面 的 模型 类 Employee, 我 们 可 以 设计 如 下 的 复合 视图 对 象 comp_view, 它 能 同时 显 
示 两 个 Employee 对 象 : 


Comp_view = View( 


@ 在 模 态 对 话 框 显示 时 ， 程 序 的 其 他 窗口 均 无 法 响应 用 户 操作 。 


Group( 
Group( 
Item('p1.department' ,label=u" 部 门 ")， 
Item('p1l.name' ，label=u" 姓 名 ")， 
Item('p1.salary' ，label=u" 工 资 ")， 
Item( 'p1.bonus' ，l1abel=u" 奖 金 ")， 
show_border=True 


Group( 
Item('p2.department'，1label=u" 部 门 ")， 
Item('p2.name' ，label=u" 姓 名 ")， 
Item('p2.salary' ，label=u" 工 资 ")， 
Item('p2.bonus' ，1abel=u" 奖 金 ")， 
show_border=True 

)， 

orientation =“horizontal” 


)， 
title = 山 "员工 对 比 " 
) 


注意 : Item 对 象 的 第 一 个 参数 不 是 简单 的 模型 对 象 的 属性 名 ， 它 同时 设置 了 Item 对 象 的 
两 个 属性 一 -object 和 name。 例 如 ， 参 数 "pl1.department" 将 设置 Item 对 象 的 object 属性 为 "p1"， 
name 属性 为 "department"。object 属性 告诉 Item 对 象 如 何 找到 模型 对 象 ， 而 name 属性 则 告诉 
Item 对 象 如 何 找到 模型 对 象 中 与 其 对 应 的 属性 。 

接 下 来 , 下 面 的 程序 生成 组 成 模型 对 象 的 两 个 Employee 对 象 一 -employeel 和 employee2: 


employeel = Employee(department = u" 开 发 ", name = u" 张 三 "，salary = 3888, bonus = 366) 
employee2 = Employee(department = u" 销 售 "，name = u" 李 四 "，salary = 48688, bonus = 466) 


在 显示 界面 时 ， 使 用 context 参数 将 包含 两 个 模型 对 象 的 字典 传递 给 configure_traits0): 
HasTraits().configure_traits(view=comp_view, context={"p1":employeel, "p2":employee2}) 


通过 context 参数 传递 的 实际 上 是 视图 对 应 的 模型 。 这 里 的 模型 对 象 是 一 个 字典 ， 它 的 键 
和 Item 对 象 的 object 属性 的 值 相同 。 由 于 已 经 通过 context 参数 传递 了 模型 对 象 ， 因 此 
configure_traits0 方 法 原本 所 属 的 对 象 将 不 会 被 用 作 界 面 的 模型 对 象 。 这 里 直接 创建 一 个 临时 的 
HasTraits 对 象 ， 然 后 调用 其 configure_traits0 方 法 。 

如 果 读 者 认为 这 种 写法 有 些 取 巧 ， 可 以 直接 调用 视图 对 象 的 ui0 方 法 显示 界面 ， 它 的 参数 
就 是 界面 所 要 显示 的 模型 对 象 。 由 于 ui0 和 edit_traits0 一 样 2 不 会 开始 界面 库 的 消息 循环 , 因此 
需要 在 运行 ui0 之 后 添加 开始 消息 循环 的 代码 。 下 面 的 消息 循环 代码 支持 所 有 的 后 台 界面 库 : 


@ 实际 上 ，edit_traits0 会 调用 视图 对 象 的 ui0 来 显示 界面 。 
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Comp_view.ui({f"p1":employee1，"p2":employee2}) 


from enthought.pyface.api import GUI 
GUI() .start_event_loop() # 开始 后 台 界 面 库 的 消息 循环 


如 果 读 者 只 需要 用 wx 库 显示 界面 ， 也 可 以 用 下 面 的 代码 来 运行 wx 库 的 消息 循环 : 


import wx 
wx.PySimpleApp() .MainLoop() # 开始 wx 库 的 消息 循环 


7.2.3 Group 对 象 


在 前 面 例子 的 视图 定义 中 ， 我 们 通过 Group 对 象 将 一 组 相关 的 Item 对 象 组 织 在 一 起 。 本 
节 详 细 介绍 如 何 使 用 Group 对 象 组 织 界面 。 

在 程序 “traitsUI viewspy” 中 ，View 对 象 中 直接 放置 了 多 个 Group 对 象 ， 效 果 如 图 7-3 
所 示 ， 它 使 用 标签 页 的 形式 显示 在 View 下 定义 的 多 个 Group 对 象 。 

如 果 希 望 能 同时 看 到 两 个 Group 对 象 ， 可 以 像 程序 “taitsUI multi modelspy” 一 样 ， 再 创 
建 一 个 Group 对 象 ， 将 那 两 个 Group 对 象 包括 起 来 ， 效 果 如 图 7-4 所 示 。 由 于 外 层 Group 对 象 
的 orientation 属性 为 horizontal， 因 此 它 内 部 的 两 个 Group 对 象 将 水 平方 向 排列 。 下 面 的 代码 显 
示 了 View 对 象 中 Group 对 象 的 嵌 套 关系 : 


View( 
Group( 
Group(...)， 
Group(...)， 


orientation = "horizontal’ 


在 创建 Group 对 象 时 ， 可 以 通过 设置 其 orientation 和 layout 等 属性 ， 改 变 Group 对 象 的 内 
容 呈 现 方式 。 由 于 某 些 设置 会 经 常用 到 ， 因 此 TraitsUI 还 提供 了 几 个 Group 的 派生 类 ， 以 覆盖 
这 些 属 性 的 默认 值 。 例 如 ， 下 面 是 从 Group 类 继承 的 HSplit 类 的 代码 : 


class HSplit ( Group ): 


layout = "split' 
orientation = "horizontal" 


HSplit 对 象 将 其 包括 的 内 容 按照 水 平方 向 排列 ， 并 且 在 两 块 区 域 之 间 添 加 一 个 可 调整 位 置 
的 分 隔 条 。 使 用 HSplit 和 如 下 的 代码 等 价 : 


Group( ... ,layout = 'split', orientation = 'horizontal') 


为 了 正确 显示 分 隔 条 ， 内 容 中 需要 有 一 个 Group 对 象 具 有 scrollable 属性 ， 如 下 面 的 省 略 


代码 所 示 : 


viewl = View( 
Hsplit( 
VGroup( 


)， 
resizable = True， 
width = 466， 
height = 156 

多 


下 面 的 程序 演示 了 4 种 不 同 的 界面 分 组 方式 ， 效 果 如 图 7-5 所 示 。 


J/ traitsUI group py 
要 用 Group 对 View 中 的 编辑 器 进行 分 组 


图 7-5 在 界面 中 用 Group 对 象 进行 分 组 


下 面 是 Group 的 各 种 派生 类 及 其 对 应 的 属性 的 默认 设置 : 
se HGroup: 内 容 水 平 排列 。 
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Group(orientation=“horizontal') 


。 HFlow: 内 容 水 平 排列 ， 当 超过 水 平 宽 度 时 ， 将 自动 换行 。show_labels 属性 为 False， 
表示 隐藏 其 中 的 所 有 编辑 器 的 标签 文字 。 


Group(orientation=“'horizontal'，1layout='flow'，show_labels=False) 
e HSplit 内 容 水 平分 隔 ， 中 间 插 入 分 隔 条 。 
Group(orientation=“'horizontal'，1layout='split') 

e Tabbed: 内 容 分 标签 页 显示 。 
Group(orientation=“'horizontal'，1layout='tabbed') 

e VGroup: 内 容 垂直 排列 。 

Group(orientation=“'vertical') 

e VFlow: 内 容 垂 直 排列 ， 当 超过 垂直 高 度 时 ， 将 自动 换 列 。 
Group(orientation=“'vertical'，1layout='flow'，show_labels=False) 
e VFold: 内 容 垂直 排列 ， 可 折 县 。 

Group(orientation= "vertical'，1layout='fold'，show_labels=False) 

e VGrid: 按照 多 列 网 格 进行 垂直 排列 ，columns 属性 决定 网 格 的 列 数 。 
Group(orientation=“'vertical'，columns=2) 

e VSplit 内 容 垂 直 排列 ， 中 间 插 入 分 隔 条 。 

Group(orientation= "vertical'，1layout='split') 


除了 上 面 的 orientation、layout、show_labels、columns 等 属性 之 外 ，Group 对 象 还 提供 了 


许多 其 他 的 属性 以 控制 其 显示 效果 。 和 Item 一 样 ， 读 者 可 以 在 Group 类 的 源 程序 中 找到 每 个 
属性 的 详细 说 明 。 


下 面 我 们 通过 一 个 例子 说 明 visible_ when 和 enabled_ when 属性 的 用 法 。 这 两 个 属性 控制 


Group 对 象 在 界面 中 是 否 显示 以 及 是 否 有 效 。 


Item 也 提供 了 visible when 和 enabled_when 属性 ， 用 法 和 Group 的 完全 相同 。 


# traitsUT group_condition.py 
二。 控制 Group 的 显示 以 及 是 否 有 效 


class Shape(HasTraits): 
shape_type = Enum("rectangle", "circle") 
editable = Bool 
x VY Wy hy r= TIntls 
View = View( 
VGroup( 
HGroup(Item("shape_type"), Item("editable")), 
VGroup(Item("x"), Item("y"), Item("w"), Item("h"), 
visible when="shape_type=="rectangle'", enabled when="editable"), 
VGroup(Item("x"), Item("y"), Item("r"), 
visible when="shape_type=="circle'", enabled when="editable"), 
), resizable = True) 


程序 中 ，Shape 是 一 个 表示 矩形 或 圆 形 的 类 ， 其 具体 形状 由 shape_type 属性 决定 ， 而 图 形 
的 参数 则 由 x、y、w、h、r 等 属性 决定 。editable 属性 决定 是 否 能 通过 用 户 界面 修改 图 形 参数 。 
在 视图 定义 中 ， 使 用 VGroup 对 象 定义 了 两 个 编辑 器 组 ， 分 别 编辑 矩形 参数 和 圆 形 参数 。 通 过 
设置 VGroup 的 visible_ when 和 enabled_when 属性 ， 将 模型 对 象 的 shape_ type 属性 和 editable 
属性 与 编辑 器 的 界面 显示 联系 起 来 。 

visible_when 和 enabled_when 属性 都 是 表示 布尔 表达 式 的 字符 串 。 当 布尔 表达 式 中 涉及 的 
模型 对 象 的 属性 发 生变 化 时 , 将 会 对 字符 串 进行 求 值 , 并 根据 求 值 结果 更 新 界面 的 显示 。 图 7-6 
是 程序 的 显示 效果 ， 其 中 左 图 对 应 的 shape_type 属性 为 "rectangle"、editable 属性 为 True。 当 
shape_type 属性 为 "rectangle" 时 , 将 显示 和 矩形 参数 的 编辑 器 而 隐藏 圆 形 参数 的 编辑 器 。 当 editable 
属性 为 False 时 ， 所 有 编辑 器 都 变 成 无 效 。 


图 7-6 演示 visible_when 和 enabled_when 属性 的 用 法 


7.2.4 配置 视图 


前 面 介 绍 了 如 何 使 用 Iem 和 Group 等 对 象 组 织 窗 口 界 面 中 的 内 容 ， 本 节 介 绍 如 何 配置 窗 
口 本 身 的 属性 。 
通过 kind 属性 可 以 修改 View 对 象 的 显示 类 型 : 
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modal: 模 态 窗口 , 非 即时 更 新 。 

"ive': 非 模 态 窗口 ， 即 时 更 新 。 
"ivemodal: 模 态 窗口 ， 即 时 更 新 。 
monmodal': 非 模 态 窗口 ， 非 即时 更 新 。 
'wizard': 向 导 类 型 。 

e ‘panel'、'subpanel': 嵌入 到 其 他 窗口 中 的 面板 ， 即 时 更 新 ， 非 模 态 窗口 。 

其 中 ，'modal、'ive'、'livemodal、"honmodal 这 4 种 类 型 的 View 对 象 都 采用 窗口 界面 来 显 
示 内 容 。 所 谓 模 态 窗口 ， 是 指 在 窗口 关闭 之 前 ， 程 序 中 的 其 他 窗口 都 不 能 被 激活 。 而 即时 更 新 
则 是 指 ， 当 窗口 中 编辑 器 的 内 容 改变 时 ， 会 立即 反映 到 编辑 器 所 对 应 的 模型 对 象 的 属性 值 。 非 
即时 更 新 的 窗口 则 会 复制 模型 对 象 ， 所 有 的 改变 在 副本 上 进行 ， 只 有 当 用 户 单 击 OK 或 Apply 
按钮 确定 修改 时 ， 才 会 修改 原始 模型 对 象 的 属性 。 

'wizard 由 一 系列 特定 的 向 导 窗 口 组 成 ， 属 于 模 态 窗口 ， 并 且 即 时 更 新 数据 。 

"panel' 和 'subpanel' 则 是 嵌入 到 窗口 中 的 面板 ,panel 可 以 拥有 自己 的 命令 按钮 ， 而 subpanel' 
则 没有 命令 按钮 。 

在 对 话 框 中 经 常 可 以 看 到 OK、Cacel、Apply 之 类 的 按钮 ， 我 们 称 之 为 命令 按钮 ， 它 们 完 
成 所 有 对 话 框 都 需要 的 一 些 共同 操作 。 在 TraitsUI 中 ， 这 些 按钮 可 以 通过 View 对 象 的 buttons 
属性 进行 设置 ， 其 值 为 要 显示 的 按钮 列表 。 

TraitsUI 中 定义 了 UndoButton、ApplyButton、RevertButton、OKButton、CancelButton 和 
HelpButton 共 6 个 标准 的 命令 按钮 ， 每 个 按钮 对 应 一 个 名 字 。 在 指定 buttons 属性 时 ,可 以 使 用 
按钮 的 类 名 或 者 它 对 应 的 名 字 。 与 按钮 类 对 应 的 名 字 就 是 类 名 除去 Button， 例 如 UndoButton 
对 应 为 "Undo"。 

enthought.traits.ui.menu 中 还 预定 义 了 一 些 命令 按钮 ， 以 方便 用 户 直 接 使 用 整套 按钮 : 


OKCancelButtons = [OKButton, CancelButton ] 
ModalButtons = [ ApplyButton, RevertButton, OKButton, CancelButton, HelpButton ] 
LiveButtons = [ UndoButton, RevertButton, OKButton, CancelButton, HelpButton ] 


7.3 用 Handler 控制 界面 和 模型 


虽然 TraitsUI 库 的 界面 设计 使 用 MVC 模式 ， 但 是 在 前 面 的 介绍 中 ， 没 有 出 现 过 任何 有 关 
控制 器 (Controller) 的 代码 ,这 是 因为 TraitsUI 库 提供 了 默认 的 控制 器 。 我 们 可 以 通过 继承 Handler 
类 ， 创 建 自己 的 控制 器 类 ， 从 而 对 视图 和 模型 进行 更 自由 的 控制 。 

控制 器 的 最 主要 功能 是 界面 的 事件 处 理 ， 这 些 事件 要 么 对 模型 对 象 进行 修 改 ， 要 么 对 界面 
进行 修改 。 模 型 、 视 图 以 及 控制 器 都 是 单独 的 实体 。 一 个 视图 对 象 可 以 为 多 个 模型 对 象 生 成 界 
面 ,同样 ， 一 个 控制 器 也 可 以 用 来 处 理 不 同 视图 界面 中 所 产生 的 事件 。 因 此 控制 器 和 视图 以 及 
模型 之 间 不 存在 静态 的 联系 。 但 是 为 了 让 控制 器 能 够 真正 起 作用 ， 它 必须 知道 自己 所 要 处 理 的 


视图 和 模型 。 在 TraitsUI 中 ， 控 制 器 使 用 UTInfo 对 象 获得 它 所 对 应 的 视图 和 模型 。 
当 TraitsUI 从 视图 创建 界面 时 , 将 创建 一 个 UIInfo 对 象 , 其 中 包括 界面 和 模型 对 象 的 引用 。 
当 界 面 事件 引起 控制 器 的 方法 被 调用 时 ， 这 个 UTInfo 对 象 会 作为 参数 传递 给 被 调用 的 方法 。 
TraitsUI 提供 了 三 种 指定 控制 器 的 方法 : 
e 将 控制 器 作为 视图 的 属性 : 使 用 视图 对 象 的 handler 属性 指定 控制 器 对 象 ， 此 视图 所 
产生 的 界面 都 使 用 它 进 行事 件 处 理 。 
。 显示 界面 时 设置 .调用 edit traits0、configure traits0 或 ui0 等 方法 显示 界面 时 ， 将 控 
制 器 对 象 传递 给 handler 参数 。 它 比 视图 的 handler 属性 有 更 高 的 优先 级 ， 将 覆盖 
handler 属性 的 设置 。 
e 将 视图 作为 控制 器 的 一 部 分 进行 定义 。 


7.3.1 用 Handler 处 理事 件 


当 显 示 某 个 视图 时 ， 将 按照 下 面 的 顺序 执行 控制 器 中 的 方法 : 

(1) 创建 一 个 UTInfo 对 象 。 

(2 执行 控制 器 的 init_info0 方 法 。 

(3) 创建 一 个 UI 对 象 以 表示 实际 的 窗口 。 

(4) 执行 控制 器 的 init0 方 法 。 

(5) 执行 控制 器 的 position0 方 法 。 

(6) 显示 实际 的 窗口 。 

除了 上 面 的 init_info0、init0、position0 之 外 ， 当 用 户 对 界面 进行 操作 时 ， 还 会 执行 如 下 的 
方法 : 
apply0: 用 户 单 击 窗口 中 的 Apply 按钮 ， 在 模型 对 象 的 数据 更 新 之 后 。 
close0: 用 户 关闭 窗口 ， 在 窗口 关闭 之 前 。 
closed0: 在 窗口 关闭 之 后 。 
IevertO: 用 户 单 击 了 Revert 或 Cancel 按钮 。 
setattr0: 用 户 通过 界面 修改 了 模型 对 象 的 某 个 Trait 属性 。 
show_help0: 用 户 单 击 了 窗口 中 的 Help 按钮 。 
下 面 通过 一 个 实例 演示 上 述 各 个 方法 的 用 法 : 


2 pd traitsUI handlerpy 
窟 用 Handler 的 方法 处 理 各 种 事件 


from enthought.traits.api import HasTraits, Str, Int 
from enthought.traits.ui.api import View, Item, Group, Handler 
from enthought.traits.ui.menu import ModalButtons 


g1 = [Item('department' ,label=u" 部 门 ")， 
Item('name' ，label=u" 姓 名 ")] 
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8g2 = [Item('salary'，label=u" 工 资 ")， 
Item('bonus' ，1abel=u" 奖 金 ")] 


class Employee(HasTraits): 
name = Str 
department = Str 
salary = Int 
bonus = Int 


def department_changed(self): © 
print self, "department changed to ", self.department 


def _str_(self): © 
return “<Employee at @x%x>" % id(self) 


Viewl = View( 
Group(*g1，label = u' 个 人 信息 '，show_border = True)， 
Group(*g2，label = u' 收 入 '，show_border = True)， 
title = u" 外 部 视图 "， 
kind = "modal", © 
buttons = ModalButtons 


[ 


) 


class EmployeeHandler(Handler): @ 
def init(self, info): 
super(EmployeeHandler, self).init(info) 
print "init called” 


def init_ info(self, info): 
super( EmployeeHandler, self).init info(info) 
print "init info called” 


def position(self, info): 
super(EmployeeHandler, self).position(info) 
print "position called" 


def setattr(self, info, obj, name, value): 
super(EmployeeHandler, self).setattr(info, obj, name, value) 
print "setattr called:%s.%s=%s" % (obj, name, value) 


def apply(self, info): 
super(EmployeeHandler, self).apply(info) 
print "apply called" 


def close(self, info, is_ok): 
super(EmployeeHandler, self).close(info, is_ok) 
print "close called: %s" % is ok 


return True 


def closed(self, info, is_ok): 
super(EmployeeHandler, self).closed(info, is_ok) 
print “closed called: %s" % is ok 


def revert(self, info): 
super(EmployeeHandler, self).revert(info) 
print "revert called" 


if _name_ == "main “: 
zhang = Employee(name="Zhang") 
print "zhang is ", zhang 


zhang.configure_traits(view=viewl, handler=EmployeeHandler()) © 


@ 在 Employee 模型 类 中 ， 定 义 了 department 属性 的 事件 处 理 方法 _department_changed0。 
@ 和 覆盖 标准 的 字符 串 转换 方法 _st 0， 用 以 显示 模型 对 象 占据 的 地 址 ?”。 

上 自 为 了 显示 对 话 框 的 标准 按钮 ， 在 创建 视图 对 象 时 设置 View 的 kind 和 button 参数 分 别 为 
modal 和 ModalButtons。 这 样 一 来 ， 界 面 所 显示 的 对 话 框 便 是 “ 模 态 窗口 、 非 即时 更 新 ”， 并 
且 有 Apply、Revert、OK、Cancel、Help 等 按钮 ， 如 图 7-7 所 示 。 


相信 


图 7-7 带 标准 按钮 的 模式 对 话 框 


@EmployeeHandler 从 Handler 继承 , 它 覆 盖 了 Handler 中 的 init、 init_info、position、setattr、 
apply、close、closed、revert 等 方法 。 如 果 close0 返 回 True， 窗 口 会 被 关闭 ， 如 果 返 回 False， 
就 不 会 关闭 窗口 。 在 这 些 方法 中 ， 将 首先 调用 父 类 中 被 覆盖 的 方法 ， 从 而 实现 默认 的 控制 器 的 
功能 。 实 际 上 ， 父 类 Handler 中 的 大 部 分 方法 不 执行 任何 任务 ， 因 此 也 可 以 不 运行 它们 ， 请 读 
者 阅读 Handler 类 的 源 代码 以 了 解 每 个 方法 的 默认 功能 。 

@ 最 后 ， 创 建 一 个 控制 器 对 象 ， 并 将 它 传递 给 configure_traits() 的 handler 参数 。 

在 了 Python 或 命令 行 中 运行 此 程序 ， 在 对 话 框 的 “部 门 ”文本 框 中 输入 “sale”， 然 后 单 击 
Apply 按钮 ， 最 后 单 击 OK 按钮 关闭 对 话 框 。 程 序 会 在 命令 行 窗口 中 输出 控制 器 的 各 个 方法 的 
调用 情况 。 

首先 ， 对 象 zhang 所 表示 的 对 象 地 址 为 “0x21794b0”: 


zhang is <Employee at 6x21794b6> 


@@ 使 用 Python 的 内 置 函 数 id0 可 以 获取 对 象 的 地 址 ， 地 址 相同 的 两 个 对 象 实际 上 是 同一 个 对 象 。 
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调用 zhang 的 configure traits0 之 后 ， 在 窗口 显示 之 前 ， 调 用 了 init info0、initO、position0 
三 个 方法 : 
init info called 


init called 
position called 


接 下 来 输入 “sale”， 每 次 输入 一 个 字符 ， 都 会 修改 模型 对 象 的 department 属性 ， 从 而 调 
用 模型 对 象 的 _department changed0， 接 着 会 调用 控制 器 的 setattr0。 因 此 控制 器 的 setattr0 是 在 
模型 数据 更 新 之 后 被 调用 的 。 


<Employee at 6x29d66f6> department changed to s 
setattr called:<Employee at 6x29d66f6> .department=s 
<Employee at 6x29d66f6> department changed to sa 
setattr called:<Employee at 9x29d66f6> .department=sa 
<Employee at 6x29d66f6> department changed to sal 
setattr called:<Employee at @x29d66f8>.department=sal 
<Employee at 9x29d66f6> department changed to sale 
setattr called:<Employee at 6x29d66f6> .department=sale 


setattr() 的 调用 参数 如 下 : 


setattr(self, info, obj, name, value) 


其 中 ，info 是 UIInfo 对 象 ，obj 是 被 修改 属性 的 模型 对 象 ，name 是 被 修改 的 属性 名 ， 而 
value 是 被 修改 之 后 的 值 。 仔 细 比 较 前 面 输出 的 对 象 地 址 就 会 发 现 : 被 修改 了 属性 的 模型 对 象 
的 地 址 并 不 是 对 象 zhang 的 地 址 。 这 是 因为 “ 非 即时 更 新 ”的 对 话 框 会 对 一 个 副本 对 象 进行 修 
改 ， 在 单 击 Apply 或 OK 按钮 时 ， 才 会 将 副本 的 内 容 写 回 原 对 象 ， 而 对 副本 对 象 的 修改 是 “ 即 
时 更 新 ”的 。 

当 单 击 Apply 按钮 时 ， 程 序 输出 了 以 下 内 容 ， 我 们 看 到 : 原始 对 象 的 department 属性 也 被 
更 新 为 “sale” 了 。 


setattr called:<Employee at 6x29d66f6> .department=sale 
<Employee at 6x21794b8> changed to sale 
apply called 


而 setatr0 再 次 被 调用 的 原因 是 : 单 击 Apply 按钮 时 ，" 部 门 "文本 框 会 失去 焦点 ， 从 而 引起 
setattr0 被 调用 。 读 者 可 以 交 蔡 单 击 界面 中 的 两 个 文本 框 ， 观 察 失 去 焦点 时 的 setattr0 调 用 。 由 于 
此 时 模型 对 象 的 department 属性 没有 变化 ， 因 此 _department_ changed0 不 会 被 调用 。 

最 后 单 击 OK 按钮 ， 程 序 输出 下 面 两 行 ， 其 中 的 True 是 is_ok 参数 的 值 ，True 表示 用 户 单 
击 的 是 OK 按钮 ， 如 果 单 击 Cancel 按钮 ， 输 出 的 将 为 False: 


close called: True 
closed called: True 


7.3.2 ”Controller 和 Ullnfo 对 象 


Handler 类 中 每 个 事件 处 理 方法 的 第 一 个 参数 都 是 UIInfo 对 象 ， 通 过 它 可 以 获得 控制 器 对 
应 的 模型 对 象 和 视图 对 象 所 产生 的 界面 。 但 是 有 时 我 们 希望 可 以 通过 控制 器 的 属性 访问 它们 。 
TraitsUI 提供 了 从 Handler 继承 的 Controller 类 ， 它 有 两 个 Trait 属性 : model 和 info， 分 别 保存 
模型 对 象 和 UImfo 对 象 。 下 面 通过 实例 介绍 Controller 的 用 法 以 及 UIInfo 对 象 的 内 容 。 


0 traitsUI UTInfo.py 
使 用 Controller 观察 UImfo 对 象 


程序 中 的 模型 和 视图 与 上 一 节 的 “traitsUI_handler.py” 相 同 。 创 建 模 型 对 象 、 控 制 器 以 及 
显示 界面 的 代码 如 下 : 


zhang = Employee(name="Zhang") 
c= Controller(zhang) 
c.configure_ traits(view=view1) 


在 创建 Controller 控制 器 时 使 用 模型 对 象 进行 初始 化 ， 之 后 可 以 通过 c.model 访问 此 模型 
对 象 。 调 用 Controller 对 象 的 configure_traits0， 不 会 显示 控制 器 本 身 的 Trait 属性 编辑 窗口 ,， 而 
是 显示 模型 对 象 的 属性 编辑 窗口 。 

在 开启 “-wthread” 选 项 的 IPython 命令 行 中 , 执行 下 面 的 语句 之 后 ， 就 可 以 交互 式 地 查看 
控制 器 c 的 内 容 了 : 


>>> run traitsUI UIInfo.py 
>>> C 
>>> “enthought .traits.ui.handler.Controller object at 8x832F58D6> 


由 于 无 论 是 控制 器 类 、 视 图 类 还 是 模型 类 ， 最 终 都 是 从 HasTraits 类 继承 ， 因 此 可 以 调用 
get0 来 快速 查看 其 内 容 : 


>>> c.get() 

{'info': <enthought.traits.ui.ui info.UIInfo object at @x8368697E@>, 
"model': <_main__.Employee object at 6x635BE9C8>} 

>>> c.info.get() 

{'initialized': True, 

"ui': <enthought.traits.ui.ui.UI object at 6x635BEC36>} 

>>> c.info.ui.get() 

[[ 省 略 ]] 


我 们 看 到 , c.info 是 一 个 UImfo 对 象 , 而 UImfo 对 象 中 最 重要 的 内 容 就 是 UI 对 象 cinfo ui。 
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UI 对 象 中 保存 有 用 户 界面 的 各 种 信息 。 对 UI 对 象 的 详细 介绍 已 超出 本 书 的 范围 ， 感 兴趣 的 读 
者 可 自行 查看 其 源 代 码 。 下 面 简要 地 查看 UI 对 象 的 几 个 属性 : 


>>> ui = c.info.ui 

>>> ui.title =“hello”# 修改 窗口 的 标题 

>>> ui.context # 存储 和 界面 相关 的 模型 、 控 制 器 对 象 的 字典 
{'controller': <enthought.traits.ui.handler.Controller object at 86x635BECF6>， 

"handler': <enthought.traits.ui.handler.Controller object at 89x635BECF9>， 

"object': <_main_.Employee object at 8x835BE9C8>} # 模型 对 象 
>>> ui.control # ui 对 象 所 表示 的 实际 界面 控件 ， 它 是 wx 库 的 一 个 Frame 对 象 ， 即 窗口 
<WX._ windows .Frame;j proxy of <Swig Object of type “wxFrame *” at 69x33b3668> > 
>>> ui.view # 创建 ui 对 象 的 视图 对 象 
( Group( 

Item( “department 
label = UN\u96e8\u95e8 

[[ 省 略 ]] 
>>> ui._editors # 界面 中 编辑 Trait 属性 用 的 编辑 器 列表 
[<enthought.traits.ui.wx.text_editor.SimpleEditor object at 9x635F3A56>， 
[[ 省 略 ]] 


7.3.3 ”响应 Trait 属性 的 事件 


前 面 曾 介绍 过 , 在 从 HasTraits 继承 的 模型 类 中 ,可 以 通过 定义 traitname_ changed0 来 响应 
traitname 属性 值 改变 的 事件 。 这 是 在 模型 类 中 响应 事件 ， 如 果 要 在 控制 器 类 中 响应 ， 可 以 通过 
定义 setattr0， 响 应 用 户 通过 界面 对 模型 对 象 的 Trait 属性 进行 修改 的 事件 。 

如 果 希 望 仅 响应 模型 对 象 中 某 个 特定 属性 的 事件 , 可 以 在 控制 器 类 中 定义 如 下 格式 的 事件 
响应 方法 : 


extended_ traitname_changed(self, info) 


setattr0 只 有 在 通过 界面 修改 模型 对 象 的 属性 时 才 会 被 调用 。 但 是 ， 只 要 模型 对 象 的 
traitname 属性 被 修改 ，extended_traitname_changed0 就 会 被 调用 ， 而 不 管 是 否 是 通过 
界面 进行 修改 。 


其 中 的 extended 是 视图 所 产生 的 UI 对 象 的 context 属性 中 与 模型 对 象 相 对 应 的 键 , 通常 都 
为 'object'。 如 果 UI 对 象 的 context 属性 是 由 context 参数 指定 ,那么 extended 可 以 是 其 中 的 任何 
一 个 模型 对 象 所 对 应 的 键 ， 在 实例 “traits multi modelspy” 中 ， 它 可 以 是 pl1' 或 p2'。 

这 样 的 事件 响应 方法 在 界面 窗口 初始 化 时 ， 以 及 在 对 应 的 属性 改变 时 都 会 被 调用 。 为 了 区 
分 二 者 ， 可 以 对 info 参数 的 initialized 属性 进行 判断 。 下 面 是 一 个 例子 : 


a traitsUI handler event.py 
在 控制 器 中 响应 模型 对 象 特定 属性 的 事件 


from enthought.traits.api import HasTraits，Bool 
from enthought.traits.ui.api import View，Handler 


class MyHandler(Handler) : 

def setattr(self, info, object, name, value): © 
Handler.setattr(self, info, object, name, value) 
info.object.updated = True ©@ 
print "setattr", name 

def object updated changed(self, info): © 
print “updated changed", "initialized=%s" % info.initialized 
if info.initialized: 

info.ui.title += "*" 


class TestClass(HasTraits): 


b1 = Bool 
b2 = Bool 
b3 = Bool 


updated = Bool(False) 
viewl = View('b1', 'b2', 'b3', 
handler=MyHandler()， 
title = "Test", 
buttons = ['OK', 'Cancel']) 


tc = TestClass() 
tc.configure traits(view=view1) 


@MyHandler 类 中 定义 了 setattr0 方 法 ， 在 通过 界面 修改 了 模型 对 象 的 任何 一 个 Trait 属性 


之 后 ， 它 将 被 调用 。@ 在 setattr0 中 修改 模型 对 象 的 updated 属性 为 True。 


目 当 模型 对 象 的 updated 属性 被 修改 时 , 它 在 控制 器 对 象 中 对 应 的 object_updated_changedO 
将 被 调用 。 由 于 updated 属性 不 是 通过 界面 修改 的 ， 因 此 这 时 setattr0 不 会 被 再 次 调用 。 


在 IPython 下 执行 此 程序 之 后 ， 直 接 修改 模型 对 象 tc 的 bl 属性 : 


>>> run traitsUI_handler_event.py 
updated changed initialized=False # 初始 化 界面 时 ， 将 调用 一 次 
>>> tc.bl = True # 直接 修改 模型 对 象 的 属性 ， 不 会 调用 控制 器 的 setattr 方法 


在 界面 中 选中 “B2” 复 选 框 ，IPython 中 将 输出 如 下 内 容 : 


updated changed initialized=True 
setattr b2 
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程序 的 执行 过 程 如 图 7-8 所 示 。 左 图 为 界面 显示 之 后 的 初始 状态 。 如 中 图 所 示 ， 直 接 修改 
模型 对 象 的 属性 不 会 触发 控制 器 的 setattr0 运 行 ， 但 是 “B1” 复 选 框 会 改 为 被 选中 ， 当 通过 界 
面 选中 “B2” 复 选 框 之 后 ， 将 调用 控制 器 的 setatr0， 从 而 设置 模型 对 象 的 update 属性 为 True， 
这 会 再 次 触发 控制 器 的 object updated changed0 运 行 ， 从 而 在 窗口 标题 中 添加 “*”。 


图 7-8 “界面 初始 状态 ( 左 )， 直 接 修改 tcbl 之 后 (中 )， 选 中 “B2” 复 选 框 之 后 ( 右 ) 
7.4 属性 编辑 器 


每 个 Trait 类 型 都 有 一 种 默认 的 界面 编辑 器 (控件 ) 与 之 对 应 , 如 果 在 视图 对 象 中 不 指定 编辑 
器 ， 将 使 用 默认 的 编辑 器 生成 界面 。 每 种 编辑 器 都 可 以 有 4 种 样式 : "simple"、"custom"、"text" 
和 "readonly": 

e "simple": 默认 值 ， 使 用 一 个 比较 简单 的 编辑 器 ， 尽 量 少 占用 界面 空间 。 

e "custom": 使 用 较 复杂 的 编辑 器 ， 尽 量 呈 现 更 多 的 内 容 。 

e "text": 使 用 一 个 文本 编辑 器 。 

e "readonly": 使 用 只 读 控件 显示 。 

TraitsUI 提供 了 丰富 的 编辑 器 库 ， 以 至 于 我 们 很 少 有 自己 设计 编辑 器 的 需求 。 由 于 TraitsUI 
的 编辑 器 种 类 繁多 ， 本 书 不 能 一 一 对 其 进行 详细 介绍 ， 感 兴趣 的 读者 可 运行 Python(x,y) 的 文档 
目录 下 的 演示 程序 ， 运 行 界面 如 图 7-9 所 示 。 


# c:\pythonxy\doc\Enthought Tool Suite\Traits\examples\demo\demo.py 
> TraitsUI 演示 程序 


7-9 TraitsUI 演示 程序 的 运行 界面 


下 面 将 以 几 个 实例 简单 地 介绍 如 何 使 用 TraitsUI 提供 的 编辑 器 。 
7.4.1 编辑 器 演示 程序 


由 于 TraitsUI 提供 了 众多 的 编辑 器 ， 并 且 每 个 编辑 器 又 有 许多 属性 配置 ， 对 它们 一 一 进行 
介绍 将 是 一 件 枯燥 无 味 的 事情 。 因 此 本 节 介绍 一 个 能 显示 各 种 编辑 器 效果 的 演示 程序 ， 图 7-10 
是 它 的 界面 截图 。 界 面 的 左 半 部 分 是 用 来 创建 各 种 Trait 属性 的 源 程序 列表 ， 对 于 选中 的 某 个 
Trait 属性 ， 在 界面 的 右 半 部 分 将 使 用 "simple"、"custom"、"text" 和 "readonly"4 种 样式 创建 属性 
编辑 器 。 


bet slre ered), es Tee ge) 


7-10 各 种 编辑 器 的 效果 演示 


traitsUI editors.py 
名 a 各 种 编辑 器 的 效果 演示 


class EditorDemo(HasTraits): 
codes = List(Str) 
selected item = Instance(EditorDemoItem) 
selected code = Str © 
View = View( 
HSplit( 
Item("codes", style="custom", show_label=False, 
editor=ListStrEditor(editable=False, selected="selected code")), © 
Item("selected item", style="custom", show_label=False), 
)， 
resizable=True, 
width = 866， 
height = 466， 
title=u" 各 种 编辑 器 演示 " 
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) 


def _selected code changed(self): 
item = EditorDemoItem(code=self.selected_code) 
item.add trait("item", eval(self.selected code)) @ 
self.selected item = item 


上 面 是 创建 主 界面 的 程序 。 在 EditorDemo 类 中 ，codes 属性 保存 一 组 用 来 创建 各 种 Trait 
属性 的 字符 串 ，selected item 属性 是 EditorDemoItem 的 对 象 。 在 EditorDemo 类 的 视图 定义 中 ， 
使 用 HSplit 将 codes 和 selected items 所 对 应 的 编辑 器 进行 水 平分 割 .@ 用 editor 参数 设置 codes 
属性 的 编辑 器 为 ListSttEditor, 它 是 一 个 显示 一 组 字符 串 的 列表 框 控 件 .其 editable 属性 为 False， 
表示 列表 框 中 的 字符 串 都 是 只 读 的 。selected 属性 是 保存 被 选中 的 字符 串 的 Trait 属性 名 ， 在 
EditorDemo 类 中 用 selected_ code 属性 保存 列表 框 中 被 选中 的 字符 串 。 可 以 通过 editor 参数 设置 
Item 对 象 的 编辑 器 ， 这 样 界 面 中 将 使 用 指定 的 编辑 器 显示 Trait 属性 。 

四 当 用 户 通过 列表 框 选中 了 某 个 字符 串 时 ，selected_code 属性 将 发 生变 化 ， 因 此 selected_ 
code_changed0 将 被 调用 。 这 里 创建 一 个 EditorDemoItem 对 象 ， 并 调用 其 add_trait0 方 法 ,动态 
地 为 其 创建 一 个 名 为 item 的 Trait 属性 , 其 类 型 则 通过 eval0 对 selected_code 字符 串 进行 求 值 获 
得 。 这 段 代 码 通过 字符 串 动态 地 创建 Trait 类 型 ， 并 使 用 此 类 型 动态 地 创建 Trait 属性 。 


class EditorDemoItem(HasTraits): 
code = Code() 
View = View( 
Group( 

Item("item"，style="simple"，1label="simple"，width=-366)，@ 
"",@ 
Item("item", style="custom", label="custom"), 
Ey 
Item("item", style="text", label="text"), 


| 


Item("item", style="readonly", label="readonly"), 
)， 
) 


在 EditorDemoItem 类 的 视图 定义 中 ， 我 们 使 用 4 种 样式 为 其 item 属性 定义 编辑 器 。 请 注 
意 在 EditorDemoItem 类 的 定义 中 并 没有 item 属性 ， 但 是 由 于 视图 中 使 用 属性 名 字符 串 定义 编 
辑 器 ， 因 此 只 有 在 真正 使 用 视图 创建 界面 时 ， 才 会 去 访问 item 属性 ， 这 时 已 经 通过 add_traitO 
为 其 添加 了 item 属性 。@Item 对 象 的 width 属性 可 以 指定 编辑 器 的 宽度 ， 以 像素 点 为 单位 的 长 
度 用 整数 表示 ， 负 数 表示 强制 设置 其 宽度 。width 属性 还 有 多 种 设置 宽度 的 用 法 ， 请 读者 查看 
Item 类 源 代码 中 的 注释 。@ 使 用 下 划 线 字符 串 在 界面 中 创建 分 割 线 。 


employee = Employee() 


demo_list = [u" 低 通 "，u" 高 通 "，u" 带 通 "，u" 带 阻 "] 


trait defines =""" 
Array(dtype="int32", shape=(3,3)) 
Bool(True) 
Button("Click me") 
List(editor=CheckListEditor(values=demo_list)) 
Code("print “hello world'") 
Color("red") 
RGBColor("red") 
Trait(*demo_list) 
Directory(os.getcwd()) 
Enum(*demo_list) 
File() 
Font() 
HTML('<b><font color="red" size="48">hello world</font></b>') 
List(Str, demo_ list) 
Range(1, 10, 5) 
List(editor=SetEditor(values=demo_list)) 
List(demo_list, editor=ListStrEditor()) 
Str("hello") 
Password("hello") 
Str("Hello", editor=TitleEditor()) 
Tuple(Color("red"), Range(1,4), Str("hello")) 
Instance(EditorDemoItem, employee) 
Instance(EditorDemoItem, employee, editor=ValueEditor()) 
Instance(time, time(), editor=TimeEditor()) 
demo = EditorDemo() 
demo.codes = [s.split("#")[8].strip() for s in trait defines.split("\n") if s.strip()!=""] 
demo.configure_traits() 


最 后 是 定义 各 种 Trait 类 型 的 程序 。 我 们 可 以 在 定义 Trait 类 型 时 ， 通 过 editor 参数 设置 其 
对 应 的 编辑 器 ， 这 样 就 不 需要 在 视图 的 Item 对 象 中 定义 了 。 

请 读者 自行 研究 每 个 Trait 类 型 的 定义 以 及 它们 所 创建 的 界面 控件 ， 这 里 就 不 再 进行 详细 
说 明了 。 


7.4.2 ”对 象 编辑 器 


随 着 程序 开发 的 进行 ， 界 面 中 的 控件 数目 会 逐渐 增多 ， 功 能 会 越 来 越 复杂 ， 这 意味 着 与 界 
面 对 应 的 模型 类 也 会 变 得 复杂 起 来 。 为 了 便于 代码 的 理解 、 管 理 以 及 重用 ， 我 们 需要 对 模型 类 
及 其 对 应 的 界面 视图 对 象 进行 重 构 。 将 程序 中 重复 使 用 、 相 对 独立 的 部 分 作为 组 件 分 离 出 来 ， 
单独 为 其 设计 模型 类 和 视图 对 象 ， 最 终 的 应 用 程序 将 由 一 系列 这 样 的 组 件 构成 。 这 些 组 件 可 以 
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在 程序 的 不 同 地 方 重复 使 用 ， 从 而 起 到 功能 分 离 、 代 码 重用 等 多 方面 的 作用 。TraitsUI 的 MVC 
模式 非常 适合 这 种 组 件 开发 方式 , 下 面 让 我 们 通过 一 些 实例 深入 理解 MVC 模式 所 带 来 的 便利 。 


sl traitsUI component.py 
组 件 演示 程序 


此 实例 程序 将 创建 一 个 如 图 7-11 所 示 的 界面 ， 用 户 可 以 通过 上 方 的 下 拉 列 表 框 选择 一 种 
形状 ， 下 方 的 控件 会 自动 根据 所 选 的 形状 发 生变 化 ， 当 通过 这 些 控件 输入 形状 数据 时 ， 界 面 下 
方 的 信息 栏 会 自动 进行 更 新 。 由 于 程序 较 长 ， 下 面 我 们 将 它 分 为 几 个 部 分 进行 分 析 。 


根据 下 拉 列 表 框 创建 不 同 的 编辑 界面 


S04 Wrote 1.414714, 5.006008 1.090080 


图 7-11 组 件 演示 ， 根 据 下 拉 列 表 框 创建 不 同 的 编辑 界面 


class Point(HasTraits): 
x = Int 
y= Int 
View = View(HGroup(Item("x"), Item("y"))) 


上 面 的 程序 定义 了 用 于 保存 平面 上 点 的 坐标 的 Point 类 . 我们 还 为 它 指定 了 一 个 视图 对 象 ， 
视图 中 XX 和 YY 轴 的 坐标 值 输入 框 是 横向 排列 的 。 在 人 Python 中 运行 下 面 的 语句 即 可 看 到 Point 
对 象 所 创建 的 界面 效果 : 


>>> Point().configure traits() 


我 们 可 以 将 Point 类 当做 组 件 使 用 ， 将 它 嵌入 到 更 复杂 的 界面 中 去 。 在 下 面 的 程序 中 定义 
了 一 个 基 类 Shape， 以 及 两 个 派生 类 Triangle 和 Circle， 并 使 用 Point 类 定义 所 有 表示 二 维 坐标 
点 的 属性 : 


class Shape(HasTraits): 
info = str © 


def _init_ (self, **traits): 
super(Shape, self)._ init (**traits) 
self.set_info() © 


class Triangle(Shape) : 
a = Instance(Point，()) © 
b = Instance(Point，()) 
c= Instance(Point，()) 


View = View( 
VGroup( 
Item("a", style="custom"), @ 
Item("b", style="custom"), 
Item("c", style="custom"), 


) 


@on_trait change("a.[x,y],b.[x,y],c.[x,y]") 
def set_info(self): 
ab,c = self.a, self.b, self.c 
11 = ((a.x-b.x)**2+(a.y-b.y)**2)**0.5 
12 = ((c.Xx-b.x)**2+(C.y-b.y)**2)**0.5 
13 = ((a.X-C.X)**2+(a.Yy-C.Yy)**2)**0.5 
self.info = "edge length: %f, %f, %f" % (11,12,13) 


class Circle(Shape): 
center = Instance(Point, ()) 
r= Int 


View = View( 


VGroup( 
Item("center", style="custom"), 
Item("r"), 

) 


) 


@on trait_change("r") 
def set_info(self): 
self.info = "area:%f" % (pi*self.r**2) 


@ 在 Shape 类 中 定义 了 一 个 info 属性 , @ 在 初始 化 方法 中 调用 派生 类 的 set_info0 以 修改 info 
属性 。 

目 在 Triangle 类 中 使 用 “Instance(Point, 0)” 定 义 了 表示 三 角形 三 个 顶点 坐标 的 属性 : a、b 
和 c。 在 Circle 类 中 使 用 同样 的 方式 定义 了 表示 圆心 坐标 的 center 属性 .这 些 属性 的 值 都 是 Point 
对 象 。Instance 的 第 二 个 参数 指定 创建 默认 对 象 时 所 用 的 参数 ， 当 没有 第 二 个 参数 时 ， 它 所 定义 
的 属性 的 默认 值 为 None， 这 里 用 一 个 空 元 组 表示 与 其 对 应 的 属性 的 默认 值 是 通过 调用 “Point0” 
得 到 的 ， 即 默认 为 Point0 所 创建 的 Point 对 象 。 

@ 如 果 Trait 属性 是 Instance 类 型 ， 并 且 它 在 视图 中 对 应 的 编辑 器 为 "custom" 样 式 ， 那 么 属 
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性 对 象 的 视图 将 直接 嵌入 到 当前 的 视图 中 。 因 此 ， 在 Triangle 和 Circle 对 象 的 编辑 界面 中 将 嵌 
入 多 个 Point 对 象 的 编辑 器 。 在 IPython 中 运行 下 面 的 程序 可 以 看 到 所 创建 的 界面 效果 : 


>>> Triangle().configure traits() 
>>> Circle().configure traits() 


接 下 来 ， 使 用 上 面 的 形状 类 创建 最 终 的 形状 选择 类 ShapeSelector: 


class ShapeSelector(HasTraits): 
select = Enum(*[cls._ name for cls in Shape._subclasses_()]) © 
shape = Instance(Shape) @ 


View = View( 
VGroup( 
Item("select"), 
Item("shape", style="custom"), © 
Item("object.shape.info", style="custom"), @ 
show_labels = False 
)， 
width = 359，height = 380, resizable = True 
) 


def _init_ (self, **traits): 
super(ShapeSelector, self)._init (**traits) 
self._select_ changed() 


def _select_changed(self) : 
klass = [cforcin Shape._subclasses_() if c._ name_ == self.select][6] 
self.shape = klass() @ 


@ 下 拉 列 表 框 所 对 应 的 select 属性 的 类 型 为 Enum( 枚 举 )， 为 了 让 程序 显得 更 自动 化 一 些 ， 
我 们 不 直接 指定 枚 举 类 型 的 候选 值 ， 而 是 通过 Shape 的 派生 类 名 创建 候选 值 列 表 。 这 样 一 来 ， 
当 我 们 添加 其 他 的 Shape 派生 类 时 ， 便 不 需要 对 这 段 代码 进行 任何 修改 。 

@shape 属性 的 类 型 是 Shape， 由 于 这 里 不 需要 创建 默认 的 Shape 对 象 ， 因 此 不 用 指定 
Instance 的 第 二 个 参数 。@ 当 select 属性 发 生变 化 时 ， 在 其 事件 处 理 方法 _select changed0 中 ， 
创建 select 属性 所 对 应 的 类 的 对 象 并 赋值 给 shape 属性 .@shape 属性 所 对 应 的 编辑 器 是 "custom" 
样式 , 因此 将 它 的 编辑 界面 作为 组 件 嵌 入 到 ShapeSelector 的 界面 中 。 并 且 它 能 根据 当前 的 shape 
属性 值 , 动态 更 新 界面 上 的 编辑 器 。 也 就 是 说 , 当 shape 属性 是 Triangle 对 象 时 , 将 使 用 Triangle 
类 的 视图 创建 编辑 器 ， 而 当 shape 属性 是 Cirlce 对 象 时， 将 使 用 Circle 类 的 视图 创建 编辑 器 。 

@ 通 过 "object.shape.info" 可 以 为 shape 属性 的 info 属性 在 界面 中 创建 编辑 器 。 当 为 某 个 Trait 
属性 的 属性 创建 编辑 器 时 ， 需 要 在 属性 名 的 前 面 添加 "object."。 

读者 也 许 会 认为 这 种 为 属性 的 属性 创建 编辑 器 的 做 法 有 些 混乱 , 一 个 比较 简单 的 解决 方法 


就 是 从 ShapeSelector 的 视图 中 删除 "objectshape info" 的 Item 对 象 ， 并 分 别 给 Triangle 和 Circle 
的 视图 添加 显示 info 属性 的 编辑 器 : Item("info"，style="custom")。 这 种 做 法 的 缺点 是 ， 需 要 给 
每 个 从 Shape 派生 的 类 的 视图 添加 info 属性 的 编辑 器 ， 而 当 我 们 不 想 显示 info 属性 时 ， 代 码 的 
修改 量 也 会 随 着 Shape 的 派生 类 的 增加 而 增加 。 

还 有 一 种 使 用 多 个 视图 对 象 的 方法 ， 它 充分 体现 了 MVC 模式 将 模型 和 视图 完全 分 离 的 
优点 。 


5 A# traitsUI component multi view.py 
二。 使 用 多 个 视图 显示 组 件 


由 于 程序 的 改动 不 大 ， 我 们 只 介绍 它 和 “traitsUI componentpy” 的 不 同 之 处 。 


class Shape(HasTraits): 
info = Str 
View info = View(Item("info", style="custom", show_label=False)) 


首先 ， 为 Shape 类 添加 一 个 view_info 视图 ， 专 门 用 于 显示 其 info 属性 。 这 样 一 来 ，Shape 
的 派生 类 Triangle 和 Circle 便 都 具有 两 个 视图 : view、view_info。 如 果 模 型 类 有 多 个 视图 ， 那 
么 当 将 其 嵌入 到 其 他 视图 中 时 ， 需 要 指定 使 用 哪个 视图 创建 编辑 器 。 因 此 ，ShapeSelector 类 的 
视图 需要 进行 如 下 修改 : 


view = View( 
VGroup( 
Item("select", show label=False), 
vsplit( © 
Item("shape", style="custom", editor=InstanceEditor(view="view")), © 
Item("shape", style="custom", editor=InstanceEditor(view="view_info")), 
show_labels = False 
y 
)， 
width = 356，height = 366，resizable = True 


) 


@ 为 了 和 前 面 的 例子 有 所 区 别 ， 这 里 用 一 个 垂直 分 隔 容器 将 形状 数据 输入 界面 和 显示 形状 
信息 的 控件 分 隔 开 。@shape 属性 的 编辑 器 样式 仍然 为 "custom", 但 是 为 了 指定 编辑 器 所 使 用 的 
视图 , 我 们 需要 通过 editor 参数 传递 一 个 InstanceEditor 对 象 。 而 通过 InstanceEditor 对 象 的 view 
参数 可 以 指定 创建 界面 时 所 使 用 的 视图 名 。 实 际 上 ，Instance 类 型 的 Trait 属性 默认 就 是 使 用 
InstanceEditor 作为 "custom" 样 式 的 编辑 器 ， 因 此 前 面 的 程序 中 都 没有 通过 editor 参数 指定 。 当 
需要 修改 InstanceEditor 对 象 的 一 些 默 认 值 时 ， 就 需要 我 们 手工 创建 它 了 。 

下 面 总 结 一 下 前 面 的 内 容 : 
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e 通过 将 Instance 类 型 的 Trait 属性 的 编辑 器 样式 指定 为 "custom", 可 以 实现 界面 的 层 层 
嵌 套 ， 即 组 件 功能 。 

。 当 模 型 类 有 多 个 视图 对 象 时 , 通过 InstanceEditor 的 view 参数 可 以 选择 其 中 的 某 个 视 
图 来 创建 编辑 此 模型 对 象 的 控件 。 

TraitsUI 的 组 件 并 不 局 限于 界面 上 的 某 一 块 区 域 ， 我 们 可 以 在 界面 中 的 不 同位 置 用 不 同 的 
视图 , 为 同一 个 模型 对 象 创建 多 个 不 同 的 编辑 器 ,因此 使 用 TraitsUI 创建 的 界面 是 非常 灵 
活 的 。 

7.4.3 ”字符 串 列表 编辑 器 


在 Traits 库 中 ，List 是 表示 列表 的 Trait 类 型 。 根 据 列 表 元 素 的 类 型 ， 可 以 使 用 不 同 的 编辑 
器 显示 其 内 容 。 让 我 们 首先 从 最 简单 的 字符 串 列 表 开 始 。 下 面 的 程序 使 用 了 三 种 不 同 的 编辑 器 
来 显示 字符 串 列表 ， 界 面 如 图 7-12 所 示 。 


a traitsUI simple list_editors.py 
简单 的 列表 编辑 器 


图 7-12 使 用 三 种 编辑 器 显示 简单 列表 属性 


filter_types = [u" 低 通 "，u" 高 通 "，u" 带 通 "，u" 带 阻 "] @ 
class ListDemo(HasTraits): 


items = List(Str) © 
View = View( 
HSplit( 
Item("items", style="custom", show_label=False), © 
Item("items", style="custom", 
editor=CheckListEditor(values=filter_ types, cols=4)), @ 
Item("items", editor=SetEditor(values=filter types)), © 
show_labels=False 
)， 
resizable=True, 
width = 666， 
title=u" 简 单列 表 编辑 器 演示 ” 


@ 首 先 创 建 一 个 列表 filter_ types, 它 表 示 列 表 属 性 中 元 素 的 可 能 取 值 。@ 定 义 items 属性 为 
字符 串 列表 类 型 ， 这 里 的 Str 表示 列表 的 元 素 类 型 必须 是 字符 串 。 

四 使 用 默认 的 列表 编辑 器 显示 items 属性 ， 效 果 如 图 7-12 左 侧 的 编辑 器 所 示 。 列 表 的 每 个 
元 素 使 用 一 个 文本 编辑 器 进行 编辑 ， 在 编辑 器 的 左 侧 有 一 个 蓝 色 的 图 标 。 单 击 此 图 标 会 弹出 一 
个 添加 、 删 除 和 改变 元 素 顺 序 的 菜单 。 使 用 此 编辑 器 可 以 为 items 属性 添加 任意 字符 串 ， 不 受 
候选 值 列表 fnter types 的 限制 。 此 外 ， 指 定 Ttem 对 象 的 style 参数 为 "custom"， 让 列表 编辑 器 
能 够 完全 显示 其 内 容 。 

@ 通 过 editor 参数 指定 编辑 器 为 CheckListEditor 对 象 。 在 创建 CheckListEditor 编辑 器 对 象 
时 ， 通 过 values 和 cols 参数 分 别 指定 候选 值 列 表 和 显示 的 列 数 。 

CheckListEditor 编辑 器 会 根据 对 应 的 Iem 对 象 的 style 属性 来 决定 所 使 用 的 控件 。 这 里 选 
用 "custom" 样 式 ， 将 使 用 复 选 框 控件 作为 编辑 器 。 如 果 样 式 为 默认 的 "simple"， 将 会 用 下 拉 列 表 
框 作为 编辑 器 。 下 拉 列 表 框 只 能 进行 单 选 ， 因 此 它 所 对 应 的 列表 属性 只 能 有 一 个 元 素 ， 请 读者 
修改 演示 程序 以 自行 验证 。 显 示 效 果 如 图 7-12 中 间 的 编辑 器 所 示 。 

人 @ 使 用 SetEditor 作为 编辑 器 ， 由 于 SetEditor 的 "simple" 和 "custom" 样 式 效果 相同 ， 因 此 不 
需要 设置 style 属性 。 效 果 如 图 7-12 右 侧 的 编辑 器 所 示 。 

使 用 其 中 任意 一 个 编辑 器 修改 属性 值 ， 其 他 的 编辑 器 也 会 同时 更 新 。 由 于 CheckListEditor 
和 SetEditor 编辑 器 将 items 属性 的 内 容 锁定 为 有 限 的 候选 项 ， 因 此 无 法 通过 最 左边 的 默认 编辑 
器 添加 其 他 的 字符 串 。 

在 上 面 的 例子 中 ，items 属性 的 候选 值 是 固定 的 ， 在 定义 ListDemo 类 时 ， 这 些 候选 值 就 已 
经 被 确定 ， 以 后 也 无 法 改变 。 但 是 有 时 我 们 希望 候选 列表 本 身 也 可 以 动态 地 改变 。 为 了 实现 这 
个 目的 ， 可 以 使 用 另外 一 个 Trait 属性 保存 候选 列表 : 


class ListDemo2(HasTraits) : 
filter_types = List(Str，value=[u" 低 通 "，u" 高 通 "，u" 带 通 "，u" 带 阻 "]) © 
items = List(Str) 
View = View( 
HGroup( 
Item("filter_types"，1abel=u" 候 选 ")，@ 
Item("items", style="custom", 
editor=CheckListEditor(name="filter types")), © 
show_labels=False 
)， 
resizable=True, 
width = 366， 
height = 186， 
title=u" 动 态 修改 候选 值 " 
J 


@ 定 义 一 个 filter_types 属性 来 保存 候选 值 列 表 ， 通 过 value 参数 指定 初始 值 。@ 在 视图 中 
使 用 默认 的 列表 编辑 器 显示 候选 值 属性 ， 用 户 通 过 它 可 以 动态 地 修改 候选 值 列表 的 内 容 。@ 在 
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创建 CheckListEditor 编辑 器 对 象 时 ， 使 用 name 参数 指定 候选 值 列表 的 属性 名 。 图 7-13 是 程序 
的 运行 效果 。 在 此 界面 中 ， 我 们 通过 左边 的 列表 编辑 器 添加 了 一 个 候选 值 : “均衡 器 ”， 右 边 
的 CheckListEditor 编辑 器 的 内 容 也 同时 发 生 了 变化 。 


图 7-13 动态 更 改 候选 值 列表 


7.4.4 ”对 象 列表 编辑 器 


当 列 表 属 性 的 元 素 是 HasTraits 对 象 时 ， 还 可 以 使 用 表格 或 标签 页 作为 它 的 编辑 器 ， 效 果 
如 图 7-14 所 示 。 


Bde nly = 
名 名 | 其 门 | 村 本 闫 辣 | TE use | 


Ear mh: [e003 EE 
用人 生理 19009 3000 基本: 10 [PT 


© ma] We: [9 


we: 150000 


贡生: [3003 


图 7-14 使 用 三 种 编辑 器 显示 对 象 列表 属性 ;表格 ( 左 )、 列 表 (中 )、 标 签 页 ( 右 ) 


sl TraitsUI list_editors.py 
使 用 三 种 编辑 器 显示 对 和 象 列表 属性 


from enthought.traits.api import HasTraits, Unicode, Int, List, Instance 
from enthought.traits.ui.api import View, Item, TableEditor, ListEditor, HGroup 
from enthought.traits.ui.table_column import ObjectColumn 


class Employee(HasTraits): 
name = Unicode(label=u" 姓 名 ") @ 
department = Unicode(label=u" 部 门 ") 
salary = Int(label=u" 薪 水 ") 
bonus = Int(1abel=u" 奖 金 ") 
View = View("name", "department", "salary", "bonus") © 


table editor = TableEditor( © 


columns = [ 
ObjectColumn(name="name" ，label=u" 姓 名 ")， 
ObjectColumn(name="department",，label=u" 部 门 ")， 
ObjectColumn(name="salary"，1abel=u" 薪 水 ")， 
ObjectColumn(name="bonus"，1label=u" 奖 金 ") 

]， 

row_factory = Employee, 

deletable = True, 

show_toolbar = True) 


list editor = ListEditor(style="custom") @ 
tab_editor = ListEditor(use_notebook=True, deletable=True, page_name=".name") @ 


class EmployeeList(HasTraits): 
employees = List(Instance(Employee, factory=Employee)) © 
View = View( 
HGroup( 

Item("employees", editor=table editor), @ 
Item("employees", editor=list_ editor), 
Item("employees", style="custom", editor=tab_editor), 
show_labels=False 


)， 
resizable=True, 
width = 666， 


title=u" 列 表 编辑 器 演示 " 
) 


首先 ，Employee 是 列表 中 对 象 的 类 型 。 在 前 面 的 例子 中 ， 界 面 中 的 标签 在 Item 对 象 中 定 
义 。 上 这 里 演示 了 另外 一 种 定义 标签 的 方法 ， 可 以 在 定义 各 个 Trait 属性 时 ， 使 用 label 参数 指 
定 它们 在 视图 中 的 标签 。@ 由 于 标签 已 经 在 Trait 属性 中 定义 ， 因 此 视图 中 可 以 不 使 用 Item， 
而 是 直接 使 用 各 个 属性 名 的 字符 串 。 

在 EmployeeList 类 中 ，employees 属性 是 一 个 Employee 对 象 的 列表 。@ 我 们 用 Instance 
(Employee) 指 定 列表 的 元 素 类 型 为 Employee 对 象 。 通 过 Instance 的 factory 参数 可 以 指定 创建 
列表 的 默认 对 象 的 工厂 函数 ， 这 里 直接 使 用 Employee 类 ， 也 可 以 通过 传递 一 个 空 元 组 来 表示 
使 用 对 应 的 类 创建 默认 对 象 。 此 工厂 函数 将 在 图 7-14( 中 ) 的 列表 编辑 器 中 用 来 给 employees 属 
性 添加 新 的 Employee 对 象 。@ 在 视图 中 ， 我 们 使 用 三 种 编辑 器 显示 employees 属性 。 

@ 用 TableEditor 创建 表格 编辑 器 ， 它 的 columns 属性 是 一 个 ObjectColumn 对 象 的 列表 ， 
每 个 ObjectColumn 对 象 描述 模型 对 象 中 与 其 对 应 的 Trait 属性 。row_factory 属性 用 于 在 表格 中 
创建 新 的 对 象 ， 这 里 也 直接 使 用 Employee 类 。deletable 属性 为 Trme， 表 示 可 以 删除 表格 中 的 
行 。show_toolbar 属性 为 True， 表 示 显 示 表 格 的 工具 栏 ， 通 过 工具 栏 可 以 删除 或 添加 行 。 

@ 当 ListEditor 编辑 器 的 style 属性 为 "custom" 时 ， 列 表 中 的 每 个 模型 对 象 都 将 使 用 与 其 对 
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应 的 视图 来 创建 编辑 器 。@ 当 ListEditor 编辑 器 的 use_notebook 属性 为 True 时 ， 将 使 用 标签 页 
显示 列表 中 的 多 个 模型 对 象 。deletable 属性 为 Tue， 表示 可 以 通过 关闭 标签 页 来 从 列表 中 删除 
模型 对 象 -page_name 属性 指定 标签 页 标题 所 对 应 的 Trait 属性 名 ,注意 属性 名 的 前 面 有 一 个 “.”。 


标签 页 的 标题 如 果 输 入 中 文 可 能 会 出 现 错误 ,请 按照 下 面 的 说 明 修改 TraitsUI 库 的 源 
代码 。 


本 书写 作 时 采用 的 TraitsUI 库 的 版 本 为 3.6， 如 果 在 标签 页 标题 中 输入 中 文 ， 会 出 现 错误 ， 
这 是 因为 TraitsUI 中 还 有 些 代码 对 Unicode 的 支持 不 够 ， 希 望 日 后 会 有 所 改善 。 目 前 可 以 通过 
分 析 错 误 提 示 信 息 ， 修 改 TraitsUI 库 中 相应 的 源 程序 。 在 下 面 的 文件 中 搜索 “???'”: 


site-packages\traitsbackendwx-3.6.0-py2.6.egg\enthought\traits\ui\wx\list editor.py 
将 相应 行 的 “str” 改 为 “unicode”， 有 两 处 需要 修改 : 


# 第 一 处 
if name is None: 
name = str( xgetattr( view object, # str 改 为 unicode 


self.factory.page_name[1:], '???" ) ) 
# 第 二 处 
name = str( name ) or '???' # str 改 为 unicode 


7.$S “菜单 、 工 具 条 和 状态 栏 


菜单 、 工 具 条 和 状态 栏 是 窗口 应 用 程序 的 标准 组 件 ， 它 们 可 以 通过 View 对 象 的 menubar、 
toolbar 和 statusbar 属性 指定 。 下 面 的 程序 演示 了 这 一 过 程 ， 效 果 如 图 7-15 所 示 。 


A traitsUI menu toolbarpy 
总 为 界面 添加 菜单 、 工 具 条 和 状态 栏 


图 7-15 为 界面 添加 菜单 、 工 具 条 和 状态 栏 


from enthought.traits.api import HasTraits, Code, Str, Int, on _trait_change 
from enthought.traits.ui.api import View, Item, Handler, CodeEditor 

from enthought.traits.ui.menu import Action, ActionGroup, Menu, MenuBar, ToolBar 
from enthought .pyface.image_resource import ImageResource 


class MenuDemoHandler(Handler): 
def exit app(self, info): 
info.ui.control.Close() 


class MenuDemo(HasTraits): 
status_info = Str 
current line = Int 
text = Code 
def traits view(self): 
file menu = Menu( @ 


) 


about_menu = Menu( 
Action(id="about"，name=u" 关 于 "，action="about_dialog")， 
name = u" 帮 助 " 


ActionGroup( 
Action(id="open"，name=u" 打 开 "，action="open_file")， 3 
Action(id="save"，name=u" 保 存 "，action="save_file")， Ey 
)， < 
ActionGroup( | 
Action(id="exit_app"，name=u" 退 出 "，action="exit_app")， 区 
A 
)， 制 
name = u" 文 件 " 作 
用 
户 
界 
面 


) 


tool_bar = ToolBar( © 
Action( 
image = ImageResource("folder page.png", search path = ["img"]), 
tooltip = u" 打 开 文档 "， 
action = "open file" 


)， 

Action( 
image = ImageResource("disk.png"，search_path = ["img"]), 
tooltip = 山 "保存 文档 "， 
action = "save file" 

)， 


) 


return View( 
Item("text", style="custom", show_label=False, 
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editor=CodeEditor(line="current_ line")), 
menubar = MenuBar(file menu, about menu), © 
toolbar = tool_ bar, 
statusbar = ["status_info"], @ 
resizable = True, 
width = 560, height = 366， 
title = u" 程 序 编辑 器 "， 
handler = MenuDemoHandler() 
内 


Q@on_trait_change("text,current_line") 
def update_status(self) : 
self.status_info = "%d:%d" % (self.text.count("\n")+1, self.current line) 
def open file(self): 
print "open file” 
def save file(self): 
print "save file” 
def about dialog(self): 
print "about dialog" 


demo = MenuDemo() 
demo.configure_ traits() 


当 视 图 的 定义 比较 复杂 时 ， 可 以 定义 名 为 traits_view 的 方法 来 返回 视图 对 象 。 


@ 菜 单 栏 是 一 个 MenuBar 对 象 ， 它 由 多 个 Menu 对 象 组 成 。@ 每 个 Menu 对 象 定义 菜单 栏 
中 的 一 个 菜单 。 在 Menu 对 象 中 ， 使 用 Action 对 象 定义 菜单 中 的 每 个 选项 ， 并 且 可 以 使 用 
ActionGroup 对 象 对 菜单 进行 分 组 。Action 对 象 的 name 属性 是 菜单 上 的 文字 ，action 属性 是 对 
应 的 事件 处 理 方法 名 ,id 属性 为 其 唯一 标识 .Action 类 还 有 许多 其 他 的 属性 , 读者 可 以 在 IPython 
中 输入 如 下 命令 来 查看 Action 及 其 父 类 的 源 代码 ， 以 了 解 更 多 的 属性 用 法 : 


>>> Action?? 
>>> Action. base_?? 


目 工 具 条 是 一 个 ToolBar 对 象 , 它 由 多 个 Action 对 象 组 成 , 每 个 Action 对 象 对 应 工具 条 中 
的 一 个 按钮 。 通过 Action 对 象 的 image 属性 可 以 指定 工具 按钮 上 显示 的 图 标 。 为 了 方便 指定 图 
标 文件 的 路 径 ， 我 们 使 用 ImageResource 管理 图 标 资源 。 

当 用 户 使 用 菜单 栏 和 工具 条 时 ， 将 运行 Action 对 象 的 action 属性 所 指定 的 事件 处 理 方法 。 
事件 处 理 方法 可 以 在 模型 类 中 定义 ， 也 可 以 在 控制 器 类 中 定义 。 在 上 面 的 例子 中 ，open_file0、 
save_fileO、about_dialog0 等 在 模型 类 中 定义 , 而 exit_app0 在 控制 器 类 中 定义 。 因 为 在 exit appO0 


中 ， 需 要 调用 后 台 界 面 库 中 窗口 对 象 的 Close0 方 法 来 关闭 应 用 程序 。 
@ 状 态 栏 则 可 以 直接 用 一 个 字符 串 列表 来 指定 ， 此 列表 中 的 每 个 字符 串 都 是 一 个 Trait 属 
性 名 。 在 状态 栏 中 将 实时 地 显示 对 应 的 Trait 属性 值 。 


7.6 设计 自己 的 编辑 器 


除了 使 用 TraitsUI 提供 的 标准 编辑 器 之 外 ， 我 们 还 可 以 使 用 自己 编写 的 编辑 器 。 这 样 可 以 
根据 应 用 程序 的 需求 ， 制 作出 更 加 专业 的 界面 。 本 节 简 要 介绍 Trait 编辑 器 的 工作 原理 ， 并 且 
制作 一 个 封装 matplotlib 绘图 控件 的 编辑 器 ， 最 后 用 它 制作 一 个 对 CSV 数据 文件 进行 绘图 的 小 
工具 。 


Traits 库 的 路 径 

如 果 读 者 想 深入 了 解 TraitsUI 的 工作 原理 ， 需 要 查看 它 的 源 程序 ， 因 此 首先 需要 知道 它 
们 在 哪里 。 下 面 所 有 的 路 径 都 在 site-packages 目录 下 。 

Traits: Traits-x.x.x-py2.6-win32.egg\enthought\traits， 以 下 简称 “%traits%6”。 

TraitsUI: Traits-x.x.x-py2.6-win32.egg\enthought\traits\UI， 以 下 简称 “%ui%”。 

wx 后 台 界 面 库 : TraitsBackendWX-x xx-py2.6eggenthoughttraitsuivwx， 以 下 简称 “obwx%b”。 


7.6.1 Trait 编辑 器 的 工作 原理 


先 看 下 面 的 小 程序 ， 它 定义 了 一 个 TestStrEditor 类 ， 其 中 有 一 个 名 为 test 的 Trait 属性 ， 类 
型 为 Str。 在 视图 view 中 定义 一 个 Item 对 象 以 显示 test 属性 ， 但 是 没有 通过 editor 参数 指定 它 
所 使 用 的 编辑 器 。 当 显示 界面 时 ，Traits 库 将 自动 挑选 文本 框 控件 作为 test 属性 的 编辑 器 。 


a traitsUI texteditor.py 
字符 串 属性 的 默认 编辑 器 


class TestStrEditor(HasTraits): 
test = Str 
View = View(Item("test")) 


通过 Trait 类 型 对 象 的 create_editor() 方 法 可 以 获得 它 的 默认 编辑 器 ， 例 如 : 


>>> 七 = TestStrEditor() 

>>> ed = t.trait("test") .trait_type.create_editor() 

>>> type(ed) 

<class “enthought.traits.ui.editors.text_editor.ToolkitEditorFactory > 
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这 个 编辑 器 对 象 ed 的 类 也 是 从 HasTraits 继承 ， 因 此 可 以 调用 get0 来 显示 它 所 有 的 Trait 属 
性 名 和 对 应 值 : 


>>> ed.get() 

{'auto_set': True， 

‘custom editor class': <class ‘enthought.traits.ui.wx.text editor.CustomEditor'>, 
"enabled': True, 

"enter_set': False, 

"evaluate': <enthought .traits.ui.editors.text editor. Identity object at 6x6427F1B6>， 
"evaluate name’: '', 

‘format_ func': None, 

‘format_str': '', 


"invalidss “> 
"is grid cell': False, 
‘mapping': {}， 


"multi line': True, 

"password': False, 

"readonly editor class': <class ‘enthought.traits.ui.wx.text editor.ReadonlyEditor'>, 
'simple editor class': «<class ‘enthought.traits.ui.wx.text editor.SimpleEditor'>, 
"text editor class': “class ‘enthought.traits.ui.wx.text editor.SimpleEditor'>, 
“view' : None} 


create_editor0 的 源 代码 可 以 在 “%traits%\trait_types.py” 中 的 BaseStr 类 的 定义 中 找到 。 
create_editor() 得 到 的 是 一 个 text_editor ToolkitEditorFactory 类 ， 它 的 完整 模块 路 径 为 : 


enthought .traits.ui.editors.text_editor.ToolkitEditorFactory 


在 “9%oui9%bveditorsvtext_ editorpy” 中 可 以 找到 它 的 定义 ， 它 从 EditorFactory 继承 ， 而 
EditorFactory 类 的 代码 在 “%buiobveditor factorypy” 中 。EditorFactory 类 是 Trait 编辑 器 的 核心 ， 
所 有 的 编辑 器 类 都 通过 它 和 后 台 界 面 库 关联 起 来 。 让 我 们 详细 看 看 EditorFactory 类 中 关于 控件 
生成 方面 的 代码 : 


class EditorFactory ( HasPrivateTraits ): 
# 下 面 4 个 属性 描述 4 个 类 型 的 编辑 器 类 
simple_editor_class = Property © 
Custom editor_class = Property 
text editor class = Property 
readonly_editor_class = Property 


# 用 simple_editor_class 创建 实际 的 控件 
def simple editor ( self, ui, object, name, description, parent ): 
return self.simple editor_class( parent, 
factory = self, 


ui = Ui, 

object = object, 

name = name, 
description = description ) 


# 这 是 类 的 方法 ， 它 通过 搜索 当前 类 和 父 类 ， 自 动 找到 与 其 匹配 的 后 台 界面 库 中 的 控件 类 
@classmethod 
def get toolkit editor(cls, class name): 四 
editor factory_classes = [factory_class for factory_ class in cls.mro() 
if issubclass(factory_class, EditorFactory)] 
for index in range(len( editor factory_classes )): 
try: 
factory_class = editor factory_classes[index] 
editor_file name = os.path.basename( 
sys.modules[factory_class. module _]._ file_ ) 
return toolkit object(':'.join([editor file name.split('.')[e], © 
class_name]), True) 
except Exception, e: 
if index == len(editor factory classes)-1: 
raise e 
return None 


# simple_editor_class 属性 的 get 方法 ， 获 取 属 性 值 
def _get_simple_editor_class(self) : 
Eny: 
SimpleEditor = self. get toolkit editor('SimpleEditor') 
except: 
SimpleEditor = toolkit object('editor_factory:SimpleEditor') 
return SimpleEditor 


QEditorFactory 对 象 有 4 个 属性 ， 分 别 用 来 保存 后 台 界 面 库 中 的 4 种 样式 的 编辑 器 类 : 
simple_editor_ class、custom_editor class、text_editor_class 和 readonly_editor_ class。 在 前 面 的 例 
子 中 ，ed 对 象 的 simple_editor_class 属性 为 : 


>>> ed.simple_editor_class 
<class “enthought.traits.ui.wx.text_editor.SimpleEditor > 


我 们 看 到 : 它 用 的 是 wx 后 台 界面 库 的 text_editor 模块 中 的 SimpleEditor 类 ， 稍 后 将 详细 
查看 它 的 代码 。 

@@EditorFactory 类 通过 类 方法 _get_toolkit_editor0 获 得 后 台 界面 库 中 的 类 。 由 于 是 类 方法 ， 
它 的 第 一 个 参数 cls 就 是 EditorFactory 类 本 身 。 当 调用 它 的 派生 类 的 _get toolkit_editor0 时 ， 第 
一 个 参数 cls 就 是 派生 类 本 身 。 通 过 调用 cls mro0 可 以 获得 cls 及 其 所 有 父 类 ， 然 后 一 个 一 个 地 
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查找 ， 从 后 台 界 面 库 中 找到 与 之 匹配 的 类 ， 这 个 工作 由 @toolkit object0 完 成 ， 其 源 代码 在 
“9oui%6\toolkit.py” 中 。 
在 后 台 界 面 库 中, 类 的 组 织 结构 和 TraitsUI 库 中 的 完全 一 样 , 因此 不 需要 额外 的 配置 文件 ， 
只 需要 几 个 字符 串 替 代 操 作 就 可 以 将 TraitsUI 库 中 EditorFactory 的 派生 类 和 后 台 界 面 库 中 实际 
的 编辑 器 类 关联 起 来 。 图 7-16 显示 了 TraitsUI 库 中 EditorFactory 和 后 台 界 面 库 的 关系 。 


trats ul Wks Ui wx 


EdiorFaciory 到 mple_edilor_class le editor SmpleE ctor 
得 天 后 右 界 重 座 中 的 安 
壁 承 
text_editor. ToolkitlEditorF actory | 


图 7-16 TraitsUI 库 中 EditorFactory 和 后 台 界 面 库 的 关系 


后 台 界 面 库 中 定义 了 所 有 编辑 器 的 控件 ， 例 如 在 “%wx%\text_editorpy” 中 可 以 找到 产生 
文本 框 控件 的 类 text_editor.SimpleEditor。 类 名 表示 控件 的 4 种 样式 一 "simple"、"custom"、 "text" 
和 "readonly"， 文 件 名 (模块 名 ) 则 表示 控件 的 类 型 。 下 面 是 text_editor.SimpleEditor 的 部 分 代码 : 


class SimpleEditor ( Editor ): 


# Flag for window styles: 
base_style = 9 


# Background color when input is OK: 
ok_color = OKColor 


# Function used to evaluate textual user input: 
evaluate = evaluate trait 


def init ( self, parent ): 
""" Finishes initializing the editor by creating the underlying toolkit 


widget. 
factory = self.factory 
style = self.base_style 


self.evaluate = factory.evaluate 
self.sync_value( factory.evaluate name, 'evaluate', 'from' ) 


if (not factory.multi line) or factory.password: 
style &= ~wx.TE_MULTILINE 


if factory.password: 
style |= wx.TE_PASSWORD 


multi line = ((style & wx.TE MULTILINE) != 6) 
if multi line: 
self.scrollable = True 


if factory.enter_set and (not multi line): 
control = wx.TextCtrl( parent, -1, self.str_value, 
style = style | wx.TE_PROCESS_ENTER ) 
WX.EVT_TEXT_ENTER( parent, control.GetId(), self.update object ) 
else: 
control = wx.TextCtrl( parent, -1, self.str_value, style = style ) 


Wx.EVT_KILL_FOCUS( control, self.update object ) 


if factory.auto set: 
Wx.EVT_TEXT( parent, control.GetId(), self.update object ) 


self.control = control 
self.set tooltip() 


真正 产生 控件 的 程序 在 init0 方 法 中 , 此 方法 在 产生 界面 时 自动 被 调用 , 注意 不 要 和 对 象 的 


初始 化 方法 


init _0 搞 混淆 ，init0 在 生成 界面 时 被 调用 。 下 面 查看 SimpleEditor 的 父 类 : 


>>> ed.simple editor class.mro() 


[<class 
<class 
<class 
<class 
<class 
<type 
<type 


"enthought .traits.ui.wx.text editor.SimpleEditor'>, 
“enthought.traits.ui.wx.editor.Editor ">， 
"enthought.traits.ui.editor.Editor ">， 
"enthought.traits.has_traits.HasPrivateTraits'>， 
"enthought.traits.has_traits.HasTraits'>， 
“CHasTraits >， 
"object'>] 


SimpleEditor 从 后 台 界 面 库 的 Editor 类 继承 ，Editor 类 中 定义 了 界面 库 编辑 器 中 一 些 通用 
的 属性 和 方法 。 而 界面 库 中 的 Editor 类 又 从 TraitsUI 库 的 Editor 类 继承 。 它 定义 了 所 有 Trait 
编辑 器 的 基本 属性 和 功能 ， 源 代码 可 以 在 “%ui%\editor.py” 中 找到 。 


7.6.2 制作 matplotlib 的 编辑 器 
Enthought 的 官方 绘图 库 采 用 的 是 Chaco， 不 过 如 果 读者 对 matplotlib 更 为 熟悉 ， 就 可 以 在 


界面 中 使 用 
编辑 器 ， 用 
所 示 。 


matplotlib 的 绘图 控件 进行 绘图 。 为 了 实现 这 个 目的 ， 我 们 需要 自己 编写 一 个 Trait 
它 封 装 matplotlib 的 绘图 控件 。 下 面 是 完整 的 源 代 码 ， 程 序 的 运行 结果 如 图 7-17 


sl mpl figure editorpy 
嵌入 TraitsUI 界面 中 的 matplotlib 控件 
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import wx 

import matplotlib 

# matplotlib 采用 WXAgg 为 后 台 ， 这 样 才能 将 绘图 控件 嵌入 以 wx 为 后 台 界 面 库 的 traitsUI 窗口 中 
matplotlib.use("WXAgg") 

from matplotlib.backends .backend wxagg import FigureCanvasWxAgg as FigureCanvas 
from matplotlib.backends .backend wx import NavigationToolbar2Wx 

from enthought.traits.ui.wx.editor import Editor 

from enthought.traits.ui.basic editor _ factory import BasicEditorFactory 


class _MPLFigureEditor(Editor): © 


相当 于 wx 后 台 界面 库 中 的 编辑 器 ， 它 负责 创建 真正 的 控件 


scrollable = True 


def init(self, parent): 
self.control = self._create_canvas(parent) 
self.set tooltip() 


def update editor(self): @ 
pass 


def _create canvas(self, parent): © 
创建 一 个 Panel， 布 局 则 采用 垂直 排列 的 BoxSizer ,在 panel 中 添加 
FigureCanvas、NavigationToolbar2Wx 和 StaticText 三 个 控件 
FigureCanvas 的 鼠标 移动 事件 调用 mousemoved 函数 ， 在 StaticText 中 
显示 鼠标 所 在 的 数据 坐标 
panel = wx.Panel(parent, -1, style=wx.CLIP_CHILDREN) 
def mousemoved(event): 

panel.info.SetLabel("%s, %s" % (event.xdata, event.ydata)) 

panel .mousemoved = mousemoved 
Sizer = WX.BoxSizer(wx.VERTICAL) 
panel.SetSizer(sizer) 
mpl_control = FigureCanvas(panel, -1, self.value) @ 
mpl_control.mpl_connect("motion_notify_event", mousemoved) 
toolbar = NavigationToolbar2Wx(mpl_control) 
sizer.Add(mpl_control, 1, wx.LEFT | wx.TOP | wx.GROW) 
sizer.Add(toolbar, 8@, wx.EXPAND|wx.RIGHT) 
panel.info = wx.StaticText(parent, -1) 
sizer.Add(panel .info) 


self.value.canvas.SetMinSize((16,16)) 
return panel 


class MPLFigureEditor(BasicEditorFactory): © 


相当 于 traits.ui 中 的 EditorFactory， 它 返回 真正 创建 控件 的 类 


klass = _MPLFigureEditor 


if _name_ ==” main “”: 
from matplotlib.figure import Figure 
from enthought.traits.api import HasTraits，Instance 
from enthought.traits.ui.api import View, Item 
from numpy import sin, linspace, pi 


class Test(HasTraits): 

figure = Instance(Figure, ()) @ 

View = View( 
Item("figure", editor=MPLFigureEditor(), show_label=False), 
width = 466， 
height = 366， 
resizable = True) 

def _init (self): 
super(Test, self)._init _() 
axes = Self.figure.add_subplot(111) 
t = linspace(86，2*pi，266) 
axes.plot(sin(t)) 


Test().configure traits() 


-La 
人 OICi+jzjam 
图 7-17 在 TraitsUI 界面 中 嵌入 的 matplotlib 绘图 控件 


由 于 这 个 matplotlib 绘图 编辑 器 没有 'simple' 等 4 种 样式 ， 也 不 会 放 到 wx 后 台 界 面 库 的 模 
块 中 ,因此 不 需要 采用 前 面 介绍 的 自动 查找 编辑 器 类 的 办 法 .对 于 这 种 情况 , TraitsUI 提 供 了 Basic- 
EditorFactory 类 以 方便 我 们 实现 编辑 器 和 后 台 界 面 库 的 连接 。 它 的 源 程序 可 以 在 “9%buiobasic _ 
editor factory.py” 中 找到 。 下 面 是 其 中 的 一 部 分 : 


class BasicEditorFactory ( EditorFactory ): 
klass = Any 
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def get simple editor class ( self ): 
return self.klass 


BasicEditorFactory 类 通过 覆盖 父 类 的 _get_simple_editor_class0 方 法 ， 直 接 返 回 创建 控件 用 
的 类 Klass。 @MPLFigureEditors 从 BasicEditorFactory 继承 , 并 指定 创建 控件 的 类 为 MPLFigureEditor。 

@_ MPLFigureEditor 和 text_editor.SimpleEditor 一 样 ， 也 从 Editor 类 继承 ， 在 它 的 init0 方 
法 中 ， 调 用 @_create_canvas0 创 建 实际 的 控件 。 

@ Editor 类 中 有 一 个 update_editor0 方 法 ， 它 在 对 应 的 Trait 属性 改变 时 会 被 调用 ， 因 为 绘 
图 控件 不 需要 这 个 功能 ， 所 以 覆盖 update_editor0， 让 它 不 做 任何 事情 。 

@ 在 matplotlib 中 ， 创 建 FigureCanvas 对 象 时 需要 指定 与 其 对 应 的 Figure 对 象 ， 这 里 
selfvalue 就 是 Figure 对 象 ，@ 它 在 模型 类 Test 中 用 一 个 名 为 figure 的 Trait 属性 表示 。 控 件 可 
以 通过 其 value 属性 获得 模型 类 中 它 所 编辑 的 对 象 。 因 此 ， MPLFigureEditor 中 的 value 属性 和 
Test 类 中 的 figure 属性 是 同一 个 Figure 对 象 。 

最 后 ，_create_canvas0 中 的 程序 编写 和 在 标准 的 wx 窗口 中 添加 控件 是 一 样 的 ， 与 界面 库 
相关 的 细节 不 是 本 书 的 重点 ， 因 此 这 里 不 再 详细 解释 , 读者 可 以 参考 matplotlib 和 wxPython 的 
相应 文档 。 


7.6.3 ”CSV 数据 绘图 工具 


用 前 面 介绍 的 matplotlib 绘图 控件 可 以 快速 制作 一 个 CSV 数据 绘图 工具 。 用 此 工具 打开 一 
个 CSV 数据 文档 之 后 ， 可 以 用 其 中 的 任意 两 列 数据 为 X、Y 轴 数 据 绘制 图 表 。 用 户 还 可 以 自 
由 地 添加 新 的 图 表 ， 修 改 图 表 的 标题 ， 选 择 图 表 的 X 轴 和 Y 轴 的 数据 。 程 序 运行 时 需要 从 
“mpl figure_editorpy” 模 块 载 入 刚才 介绍 的 matplotlib 绘图 控件 模块 。 程 序 的 界面 如 图 7-18 
所 示 ( 见 文 前 彩 插 )。 


a traitsUI_ csv_viewer.py 
使 用 matplotlib 绘图 控件 制作 CSV 数据 绘图 工具 


图 7-18 CSV 数据 绘图 工具 的 界面 


程序 以 标签 页 的 形式 显示 多 个 绘图 ， 用 户 可 以 从 左 侧 的 数据 选择 栏 中 选择 X 轴 和 Y 轴 的 
数据 。 标签 页 可 以 自由 地 拖 动 , 构成 上 下 左右 分 栏 , 并 且 可 以 隐藏 左 侧 的 数据 选择 栏 , 如 图 7-19 
所 示 ( 见 文 前 彩 播 )。 


图 7-19 使 用 可 调整 DOCK 的 多 标签 页 界面 ， 方 便 用 户 对 比 数据 


由 于 绘图 控件 是 matplotlib 提供 的 ， 因 此 平移 、 缩 放 、 保 存 文件 等 功能 也 一 应 俱全 。 由 于 
所 有 的 界面 都 是 采用 TraitsUI 设计 的 ， 因 此 主 窗口 既 可 以 用 来 单独 显示 ， 也 可 以 嵌入 到 一 个 更 
大 的 界面 中 ， 运 用 十 分 灵活 。 

程序 中 已 经 有 比较 详细 的 注释 ， 这 里 不 再 重复 。 如 果 读 者 对 Traits 库 的 某 项 用 法 还 不 太 了 
解 ， 可 以 直接 查看 其 源 代码 ， 代 码 中 都 有 详细 的 注释 。 整 个 程序 的 界面 处 理 都 只 是 组 装 View 
对 象 ， 看 不 到 任何 关于 控件 操作 的 代码 ， 因 此 大 大 节省 了 程序 的 开发 时 间 。 


标签 页 的 标题 如 果 输 入 中 文 可 能 会 出 现 错误 ， 请 按照 7.4.4 节 的 说 明 修改 TraitsUI 库 
的 源 代 码 。 
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Chaco 一 一 交互 式 图 表 


Chaco 是 Enthought 公司 开发 的 二 维 绘图 库 ， 它 以 Traits 为 基础 ， 提 供 了 十 分 丰富 的 交互 
功能 。 如 果 读者 安装 了 Python(x,y)， 那 么 可 以 在 它 的 安装 目录 下 找到 Chaco 的 演示 程序 : 


Cc:\pythonxy\doc\Enthought Tool Suite\Chaco\examples\demo.py 


运行 此 程序 之 后 ， 将 看 到 如 图 8-1 所 示 的 窗口 ( 见 文 前 彩 插 )。 


8-1 ”Chaco 的 演示 程序 ， 可 以 同时 查看 源 程序 和 运行 结果 


在 此 窗口 中 , 选择 左 栏 中 的 某 个 演示 程序 ， 它 的 相关 源 代 码 将 显示 在 “Source” 标 签 页 下 ， 
而 其 运行 结果 则 显示 在 “Demo” 标 签 页 下 。 通 过 学 习 这 些 演示 程序 ， 可 以 快速 掌握 Chaco 的 
基本 用 法 。 

本 章 在 简要 介绍 Chaco 的 基本 绘图 功能 之 后 ， 将 着 重 介绍 各 种 图 表 交 互 工具 的 使 用 和 开 
发 。 在 应 用 程序 的 界面 中 使 用 Chaco 图 表 以 及 各 种 交互 工具 ， 能 提高 程序 的 可 用 性 ， 让 用 户 更 
方便 地 观察 数据 。 


8.1 面向 脚本 绘图 


Chaco 提供 了 与 matplotlib 的 pyplot 模块 类 似 的 绘图 方式 ， 我 们 称 之 为 面向 脚本 绘图 。 下 
面 的 程序 使 用 面向 脚本 的 方式 进行 快速 绘图 ， 效 果 如 图 8-2 所 示 。 


# chaco_script.py 
六 二 使 用 Chaco 的 面向 脚本 的 API 快 速 绘 图 


import numpy as np 
import enthought.chaco.shell as cs © 


x = np.linspace(-2*np.pi, 2*np.pi, 160) 
y = np.sin(x) 


Esplot(x yy 人 
cs.title("First plot") 
cs.ytitle("sin(x)") 
cs.show() 


8-2 ”使 用 Chaco 的 脚本 绘图 API 绘制 正弦 波 


@ 首 先 载 入 面向 脚本 的 绘图 模块 chaco.shell。@ 调 用 plot0 绘 制 曲 线 ， 参数 x 和 y 是 表示 曲 
线 上 各 点 的 X-Y 轴 坐 标的 数组 。 第 三 个 参数 指定 曲线 的 样式 ，"r" 表 示 曲 线 的 颜色 为 红色 ，"-" 
表示 曲线 的 线 型 为 实 线 。 接 下 来 通过 tile0 为 图 表 添加 标题 ，ytitle0 为 了 轴 添加 标题 ,最 后 调用 
show0 显 示 图 表 。 

脚本 绘图 不 是 Chaco 的 强项 ， 虽 然 它 的 脚本 绘图 API 和 matplotlib 的 十 分 相似 ， 但 是 功能 
却 没有 matplotlib 的 丰富 。 使 用 Chaco 的 优势 在 于 它 可 以 很 方便 地 嵌入 到 用 TraitsUI 编写 的 界 
面 程序 中 ， 并 且 提供 了 很 多 和 图 表 进 行 交 互 的 工具 ， 能 够 方便 我 们 开发 包含 交互 式 图 表 的 应 用 
程序 。 


8.2 面向 应 用 绘图 


为 了 将 Chaco 的 图 表 嵌 入 到 用 TraitsUI 制作 的 界面 程序 中 ， 需 要 做 一 些 额外 的 工作 ， 因 此 
代码 量 要 比 面向 脚本 绘图 多 许多 ， 不 过 同时 也 更 具有 灵活 性 。 让 我 们 先 从 一 个 最 简单 的 例子 开 
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始 ， 它 的 运行 结果 如 图 8-3 所 示 ， 效 果 和 采用 脚本 方式 类 似 。 


A# chaco_simple line.py 
守 忆 ”将 Chaco 图 表 嵌入 到 用 TraitsUI 制作 的 界面 程序 中 


import numpy as np 

from enthought.traits.api import HasTraits, Instance 

from enthought.traits.ui.api import View, Item 

from enthought.chaco.api import Plot, ArrayPlotData © 

from enthought .enable.component_editor import ComponentEditor © 


class Lineplot(HasTraits): 
plot = Instance(Plot) © 
data = Instance(ArrayPlotData) 
traits_view = View( 
Item('plot' ,editor=ComponentEditor(), show_label=False), @ 
width=560, height=5860, resizable=True, title="Chaco Plot") 


def _init (self, **traits): 
super(Lineplot, self)._init (**traits) 
x = np.linspace(-14，14，166) 
y = np.sin(x) * x**3 
data = ArrayPlotData(x=x, y=y) © 
plot = Plot(data) @ 
plot.plot(("x", "y"), type="line", color="blue") @ 
plot.title = "sin(x) * x^3" © 
self.plot = plot 
self.data = data 


if _name _ == ”main 
p = LinePlot() 
p.configure traits() 


程序 看 起 来 比较 复杂 ， 但 只 要 掌握 
了 它 的 基本 设计 思想 , 就 很 容易 理解 了 。 
程序 中 首先 从 许多 模块 载 入 对 象 ，@ 从 
Chaco 库 载 入 Plot 类 和 ArrayPlotData 类 ， 
Plot 是 一 个 封装 了 各 种 绘图 功能 的 类 , 而 
ArrayPlotData 是 用 来 保存 绘图 数据 的 类 。 
即 Plot 负责 图 表 的 绘制 ，ArrayPlotData 
负责 管理 图 表 数 据 。@ 从 Enable 库 载 入 
ComponentEditor， 它 负责 在 界面 上 显示 ”图 8-3 将 Chaco 图 表 嵌 入 到 使 用 TraitsUI 制作 的 界面 程序 中 


Plot 对 象 所 表示 的 图 表 。 

LinePlot 类 从 HasTraits 继承 ，@ 它 有 两 个 Trait 属性 一 plot 和 data， 用 Instance 定义 它们 
分 别 是 Plot 和 ArmayPlotData 的 实例 。@ 在 视图 的 定义 中 ， 指 定 plot 属性 的 编辑 器 为 一 个 
ComponentEditor 对 象 ， 这 样 它 就 能 负责 在 界面 中 显示 Plot 对 象 了 。 

在 LinePlot 类 的 初始 化 方法 _init 0 中 ， 首 先 计 算出 表示 正弦 波 的 数组 x 和 y。@ 然 后 创 
建 一 个 存储 绘图 数据 的 ArrayPlotData 对 象 data， 并 通过 关键 字 参 数 将 两 个 数组 传递 给 它 。 
ArrayPlotData 对 象 可 以 像 字典 一 样 使 用 ， 可 以 通过 关键 字 参 数 名 获得 其 对 应 的 数组 。 例 如 ， 在 
IPython 命令 行 中 输入 下 面 的 语句 ， 可 以 从 data 对 象 获得 数组 x: 


>>> run chaco_simple line.py 
>>> p.data["x"] 
array([-14. ，-13.71717172，-13.43434343，-13.15151515，…… 


@ 接 下 来 创建 Plot 对 象 ， 并 将 存储 绘图 数据 的 ArrayPlotData 对 象 传递 给 它 ， 此 后 Plot 对 
象 将 通过 数组 名 从 ArrayPlotData 对 象 中 获得 实际 的 数组 。 这 样 就 在 图 表 和 数据 之 间 形 成 了 一 个 
接口 : 修改 AmrayPlotData 对 象 中 的 数组 将 会 反映 到 与 此 数组 相关 的 Plot 对 象 之 上 , 而 多 个 Plot 
对 象 也 可 以 共用 同一 个 ArrayPlotData 对 象 。 通 过 Plot 对 象 的 data 属性 可 以 获得 与 其 关联 的 
ArrayPlotData 对 象 : 


>>> p.plot.data == p.data 
True 


Plot 类 对 Chaco 库 中 的 许多 绘图 类 进行 封装 ， 提 供 了 一 个 统一 的 接口 以 方便 用 户 创建 和 管 
理 这 些 绘图 对 象 。@ 调 用 其 plot0 创 建 一 个 曲线 图 对 象 , 我们 只 将 数组 名 传递 给 它 ， 它 将 通过 数 
组 名 在 其 data 属性 中 找到 对 应 的 数组 。type 参数 为 "line" 表 示 绘 制 曲线 图 ， 曲 线 的 颜色 由 color 
参数 指定 。@ 最 后 通过 设置 Plot 对 象 的 title 属性 ， 修 改 图 表 的 标题 。 
显然 ， 这 段 程序 比 前 面 的 脚本 绘图 程序 要 复杂 许多 ， 为 了 方便 读者 理解 ， 下 面 对 上 面 的 绘 
图 程序 做 一 个 总 结 : 
e 创建 一 个 从 HasTraits 继承 的 类 , 给 它 定义 一 个 类 型 为 Plot 的 Trait 属性 , 并 在 视图 定 
义 中 为 此 属性 指定 一 个 ComponentEditor 对 象 作为 编辑 器 。 
e 创建 表示 绘图 数据 的 数组 ， 并 使 用 ArrayPlotData 对 象 封装 这 些 数组 。 
e 创建 Plot 对 象 ， 将 ArrayPlotData 对 象 传递 给 它 ， 并 用 plot 属性 保存 Plot 对 象 。 
e 调用 Plot 对 象 的 plot0 方 法 绘图 , 不 直接 将 数组 传递 给 plot0, 而 是 使 用 ArrayPlotData 
对 象 中 的 数组 名 。 


8.2.1 多 条 曲线 


采用 和 上 一 节 相 同 的 方法 , 我 们 可 以 用 下 面 的 程序 在 一 幅 图 表 中 绘制 多 条 曲线 , 效果 如 图 
8-4 所 示 ( 见 文 前 彩 插 )。 由 于 程序 的 结构 和 上 一 节 的 例子 相同 ,下面 只 给 出 初始 化 方法 _init 0 
的 代码 : 
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s # chaco_multiple line.py 
全 一 绘制 多 条 曲线 


def _ init_ (self, **traits): 
super(MutiLineplot, self). init (**traits) 
x = np.linspace(-14，14，166) 
y1 = np.sin(x) * x**3 
y2 = np.cos(X) * x**3 
data = ArrayPlotData(x=x，y1=y1，y2=y2) 
plot = Plot(data) 
plot.plot(("x", "y1"), type="line", color="blue", name="sin(x) * x**3") © 
plot.plot(("x", "y2"), type="line", color="red", name="cos(X) * x**3") 
plot.plot(("x", "y2"), type="scatter", color="red", marker = "circle", @ 
marker_size = 2, name="cos(x) * x**3 points") 
plot.title = "Multiple Curves” 
plot.legend.visible = True © 
self.plot = plot 
self.data = data 


Multiple Curves 


一 ceslxj * x**3 


图 8-4 绘制 多 条 曲线 并 显示 图 示 


在 _init 0 中 调用 了 3 次 Plot 对 象 的 plot0 方 法 ，@ 前 两 次 分 别 绘制 正弦 曲线 和 余弦 曲线 ， 
type 参数 为 "line"， 表 示 绘 制 曲线 图 。@type 参数 为 "scatter"， 表 示 只 绘制 数据 点 ， 不 使 用 直线 
将 它们 连接 起 来 。 通 过 marker 和 marker_size 等 参数 可 以 设置 点 的 样式 和 大 小 。 

全 Plot 对 象 的 legend 属性 是 表示 图 示 的 对 象 , 这 里 通过 设置 它 的 visible 属性 在 图 表 上 显示 
图 示 。 图 示 中 将 显示 每 次 调用 plotO 时 传递 的 name 参数 。 如 果 没 有 设置 name 参数 ， 系 统 会 自 
动 为 其 设置 一 个 值 。 


下 面 在 IPython 中 运行 程序 ， 然 后 观察 Plot 对 象 的 内 容 : 


>>> run chaco_multiple_line.py 
>>> plot = p.plot # p 是 包含 Plot 对 象 的 MutiLinePlot 对 象 


plot 是 一 个 Plot 对 象 ， 让 我 们 看 看 Plot 类 的 继承 列表 : 


>>> plot._class_.mro() 

[<class “enthought.chaco.plot.Plot'>， 

<class “enthought.chaco.data_view.DataView'>， 

<class “enthought.chaco.plot_containers.0verlayPlotContainer ">， 
<class “enthought.chaco.base_plot_container.BasePlotContainer '>， 
<class “enthought.enable.container.Container ">， 

<class “enthought.enable.component.Component ">， 

<class “enthought.enable.coordinate_box.CoordinateBox '>， 

<class “enthought.enable.interactor.Interactor ' >， 

<class ‘enthought.traits.has traits.HasTraits'>, 

<type 'CHasTraits'>, 

<type 'object'>] 


由 于 Plot 从 HasTraits 继承 , 因此 它 的 所 有 属性 都 是 Trait 属性 。 它 从 Enable 库 的 Component 
类 (组 件 类 ) 继 承 ， 所 以 在 定义 视图 时 可 以 使 用 Enable 库 的 ComponentEditor 作为 Plot 对 象 的 编 
辑 器 ， 关 于 这 部 分 内 容 将 在 后 面 详细 介绍 。 它 还 从 Container 继承 ， 因 此 Plot 对 象 可 以 包含 其 
他 的 绘图 对 象 。 在 上 面 的 例子 中 ，Plot 对 象 包含 了 通过 plot0 方 法 创建 的 三 条 曲线 (其 中 有 一 条 
只 显示 数据 点 )， 这 些 绘图 对 象 都 保存 在 Plot 对 象 的 components 属性 中 。 


每 个 Trait 属性 的 用 法 在 源 程序 中 都 有 很 详细 的 注释 ， 因 此 建议 读者 通过 阅读 Chaco 
本 的 源 程序 来 加 深 理解 。 


>>> plot.components 

[<enthought.chaco.1ineplot.LinePlot object at 9x65A35C66>， 
<enthought.chaco.lineplot.LinePlot object at @x85A3C860>, 
<enthought.chaco.scatterplot.ScatterPlot object at 9x65A3C3F6>] 


我 们 看 到 : 当 type 参数 为 "line" 时 ，plot0 创 建 LinePlot 对 象 表示 曲线 图 ， 当 type 参数 为 
"scatter" 时 ， 创 建 ScatterPlot 对 象 表示 散 列 图 。 

Plot 对 象 的 plots 属性 是 一 个 包含 用 plot0 创 建 的 绘图 对 象 的 字典 ， 键 是 绘图 对 象 的 name 
属性 : 


>>> plot.plots 
{'cos(x) * x**3': [<enthought.chaco.lineplot.LinePlot object at 6x65A3C866>]， 
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Plot 对 象 的 overlays 属性 中 有 一 个 PlotLabel 对 象 和 一 个 Legend 对 象 ， 它 们 分 别 是 图 表 的 
标题 和 图 示 : 


>>> plot.overlays 
[<enthought.chaco.plot_label.PlotLabel object at 89x65A36E76>， 
<enthought .chaco. legend.Legend object at 6x65A35816>] 


underlays 属性 中 保存 有 两 个 PlotGrid 对 象 和 两 个 PlotAxis 对 象 ， 它 们 分 别 是 图 表 中 X 轴 
和 YY 轴 的 网 格 ， 以 及 义 轴 和 YY 轴 本 身 : 


>>> plot.underlays 

[<¢enthought .chaco.grid.PlotGrid object at @x85A2A510>, 
<enthought. chaco.grid.PlotGrid object at 9x65A2AED6>， 
<enthought .chaco.axis.PlotAxis object at 9x65A368A6>， 
<enthought. chaco.axis.PlotAxis object at 9x65A36B76>] 


所 有 这 些 对 象 都 从 HasTraits 继承 ,可 以 调用 各 个 对 象 的 edit_traits0 方 法 , 显示 出 编辑 它们 
的 属性 的 界面 ， 如 图 8-5 所 示 ， 通 过 这 些 界面 可 以 交互 式 地 修改 对 象 的 各 种 属性 。 


有 些 对 象 没有 默认 视图 ， 因 此 调用 它们 的 edit_traits0 方 法 会 自动 根据 其 Trait 属性 创 
建 界面 ， 而 自动 创建 界面 可 能 会 失败 。 这 时 我 们 可 以 在 调用 edit_traitsO 时 传递 一 个 自 
已 创建 的 视图 对 象 。 


>>> plot.underlays[6].edit_traits() 
>>> plot.underlays[2].edit_traits() 
>>> plot.components[6].edit_traits() 


Plot 对 象 会 按照 一 定 的 顺序 绘制 其 中 包含 的 各 个 对 象 。 这 个 顺序 可 以 通过 其 draw_order 属 
性 获得 : 


>>> p.plot.draw_order 
['background', 'image', "underlay', "plot'， 
"selection', ‘border', ‘annotation'’, 'overlay'] 


可 以 将 draw_order 属性 中 的 每 个 元 素 当做 一 个 类 似 于 透明 纸 的 绘图 层 , Plot 对 象 中 的 每 个 
绘图 元 素 都 在 其 中 的 一 张 透明 纸 上 进行 绘制 , 最终 的 结果 就 是 这 些 透 明 纸 按照 draw_order 的 顺 
序 从 下 往 上 县 加 在 一 起 。underlays 属性 中 的 对 象 在 "nderlay' 层 上 绘制 ，components 属性 中 的 对 
象 在 plot 层 上 绘制 ， 而 overlays 属性 中 的 对 象 则 在 'overlay' 层 上 绘制 。 因 此 坐标 轴 和 网 格 被 数据 
曲线 覆盖 ， 而 标题 和 图 示 则 能 够 覆盖 数据 曲线 。 
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图 8-5 用 edit_traits0 显 示 出 各 个 对 象 的 编辑 界面 


LinePlot、ScatterPlot、PlotLabel、Legend、PlotGrid 和 PlotAxis 等 都 是 绘图 组 件 ， 它 们 都 
从 Enable 库 的 Component 继承 ， 例 如 下 面 的 程序 查看 PlotLabel 的 父 类 : 


>>> plot.overlays[8]._ class_.mro() 

[<class “enthought.chaco.plot_label.PlotLabel' >， 
<class “enthought.chaco.abstract_overlay.AbstractOverlay >， 
<class “enthought.chaco.plot_component.PlotComponent '>， 
<class “enthought.enable.component.Component '>， 
<class “enthought.enable.coordinate_box.CoordinateBox >， 
<class “enthought.enable.interactor.Interactor ">， 
<class ‘enthought.traits.has traits.HasTraits'>, 
<type 'CHasTraits'>, 
<type “object '>] 


和 Plot 类 不 同 的 是 ，PlotLabel 不 从 Container 继承 ， 因 此 它 不 能 包含 其 他 的 绘图 元 素 。 我 
们 可 以 做 如 下 总 结 : 图 表 中 的 每 个 组 件 都 是 一 个 Component 对 象 ， 有 些 组 件 还 是 Container 对 
象 ， 它 们 可 以 包含 其 他 的 组 件 ， 有 些 不 是 Container 对 象 ， 它 们 与 图 表 中 的 某 个 绘图 实体 对 应 。 


8.2.2 ”Plot 对 象 的 结构 


前 面 介绍 了 Plot 对 象 有 三 个 属性 分 别 保存 它 所 包含 的 其 他 组 件 : overlays、underlays 和 
components。 这 些 属 性 都 和 绘图 相关 ，Plot 类 从 Enable 库 的 Component 类 和 Container 类 继承 
了 这 些 属 性 。 而 一 幅 图 表 除 了 能 显示 绘图 结果 之 外 ， 还 需要 能 对 数据 进行 处 理 ， 因 此 Plot 类 中 
还 有 许多 和 数据 相关 的 属性 。 图 8-6 显示 了 Plot 对 象 和 其 他 对 象 之 间 的 关系 。 下 面 以 上 一 节 的 
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“chaco mnultiple linepy” 为 例 ， 在 IPython 中 观察 Plot 对 象 的 内 部 结构 。 


\nee_ ame | 


NA 


图 8-6 Plot 对 象 的 结构 


本 节 介 绍 的 类 大 都 从 HasTraits 继承 ， 因 此 可 以 通过 它们 的 get0 或 print_traits0 方 法 快 
到 速 查看 所 有 的 Trait 属性 。 


Plot 对 象 是 一 个 容器 ， 图 中 用 立体 矩形 表示 。LinePlot、PlotAxis 和 PlotGrid 是 绘图 组 件 ， 
用 填充 矩形 表示 。 图 中 的 箭头 表示 对 象 之 间 的 引用 关系 。 例 如 Plot 对 象 的 data 属性 是 一 个 
ArrayPlotData 对 象 ， 因 此 图 中 用 一 条 标记 为 data 的 箭头 曲线 将 二 者 连接 起 来 : 


>>> plot = p.plot 
>>> plot.data 
<enthought.chaco.array_plot_data.ArrayPlotData object at 86x6524E276> 


ArrayPlotData 的 array 属性 是 一 个 字典 ， 它 将 数组 名 和 数组 联系 起 来 。ArrayPlotData 同时 
覆盖 了 getitem 0， 因 此 它 本 身 也 可 以 当做 字典 使 用 : 


>>> plot.data["x"] 
array([-14. ，-13.71717172，-13.43434343，...]) 


Plot 对 象 同时 提供 了 一 个 用 于 保存 数据 的 datasources 属性 ， 它 和 字典 对 象 类 似 ， 键 是 数组 


名 , 值 是 对 数组 进行 封装 的 ArrayDataSource 对 象 。 通过 ArrayDataSource 对 象 的 get_data0 方 法 
可 以 获得 其 内 部 封装 的 数组 。ArrayDataSource 对 象 还 提供 了 一 个 用 来 描述 数组 的 metadata 字 
典 , 可 以 往 其 中 任意 添加 描述 数组 的 数据 。 在 后 面 介绍 交互 工具 时 , 我 们 还 会 详细 学 习 metadata 
字典 的 用 法 。 


>>> plot.datasources["x"] 
<enthought.chaco.array_data_source.ArrayDataSource object at 86x652DB966> 
>>> plot.datasources["x"].get_data() 

array([-14. ，-13.71717172，-13.43434343，. ..]) 

>>> plot.datasources["x"].metadata 

{f "annotations': [], 'selections': []} 


Plot 对 象 是 一 个 容器 组 件 ， 它 所 包含 的 组 件 都 保存 在 components 列表 属性 中 。 调 用 plot0 
时 ， 会 自动 创建 各 种 绘图 组 件 并 将 它们 添加 到 此 列表 中 。 在 本 例 中 ， 第 一 次 调用 plotO 时 创建 
的 是 一 个 LinePlot 对 象 ， 通 过 它 的 container 属性 可 以 获得 包含 它 的 Plot 对 象 。LinePlot 对 象 的 
index 属性 表示 曲线 X 轴 的 数据 , value 属性 表示 立轴 的 数据 。 它们 都 是 Plot 对 象 的 datasources 
属性 中 的 ArrayDataSource 对 象 。 


>>> plot.components[6] 

<enthought.chaco.1lineplot.LinePlot object at 69x852DB9F6> 

>>> plot.components[6].index 
<enthought.chaco.array_data_source.ArrayDataSource object at 69x652DB966> 


LinePlot 对 象 使 用 两 个 LinearMapper 对 象 一 index_mapper 和 value_mapper， 分 别 用 来 将 
X 轴 和 立轴 的 数据 转换 到 屏幕 坐标 系 。 


>>> plot.components[8].index_mapper 
<enthought.chaco.1linear_mapper.LinearMapper object at 8x852DB936> 


在 LinearMapper 对 象 中 , map_screen0 将 数组 从 数据 坐标 系 转换 为 屏幕 坐标 系 。 map_data() 
是 map_screen0 的 逆 变 换 ， 它 将 数组 从 屏幕 坐标 系 转换 为 数据 坐标 系 。 


>>> plot.components[6].index_mapper.map_screen(np.array([8,1,2])) 
Out[23]: array([ 198.5 ， 264.16714286， 217.71428571]) 


为 了 进行 坐标 变换 ，LinearMapper 对 象 通过 它 的 range 属性 获得 数据 的 范围 , range 属性 是 
一 个 DataRangelD 对 象 。 由 于 DataRangelD 对 象 可 以 同时 计算 多 组 数据 的 范围 ， 因 此 它 的 
sources 属性 是 一 个 ArrayDataSource 对 象 的 列表 。 


>>> plot.components[6].index_mapper.range 
<enthought.chaco.data_range_1d.DataRangelD object at 6x652D16F6> 

>>> plot.components[6].index_mapper.range.sources[6] 

Out[29]: <enthought.chaco.array_data_source.ArrayDataSource object at 6x652DB986> 
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通过 LinePlot 对象 的 index_range 属性 也 可 以 获得 表示 义 轴 数 据 范围 的 DataRangelD 对 象 ， 
通过 value_range 属性 获得 表示 Y 轴 数 据 范围 的 对 象 。 


>>> plot.components[6].index_range 
<enthought .chaco.data_range_1d.DataRange1D object at 6x652D16F6> 


Plot 对 象 的 underlays 列表 中 包含 两 个 PlotAxis 对 象 和 两 个 PlotGrid 对 象 , 它们 也 可 以 通过 
Plot 对 象 的 index_axis、value_ axis、index_grid 和 value_grid 等 属性 获得 。 通过 它们 的 component 
属性 可 以 获得 包含 它们 的 Plot 对 象 。PlotAxis 和 PlotGrid 对 象 也 需要 进行 坐标 系 变换 运算 ， 因 
此 它们 的 mapper 属性 都 指向 一 个 LinearMapper 对 象 。 注 意 它 和 LinePlot 对 象 的 index_mapper 
不 是 同一 个 对 象 。 但 是 这 两 个 LinearMapper 对 象 使 用 同一 个 DataRangelD 对 象 。 这 部 分 内 容 
请 读者 自行 在 IPython 中 进行 验证 。 

Chaco 提供 多 种 进行 坐标 转换 的 Mapper 类 ， 多 种 表示 数据 范围 的 DataRange 类 ， 以 及 多 
种 表示 数据 源 的 DataSource 类 。 它 们 分 别 从 AbsractMapper AbstractDataRange 和 AbstractDataSource 
等 抽象 类 继承 。 下 面 的 小 程序 输出 这 些 抽象 类 的 所 有 子 类 。 


S A chaco_classes.py 
这 一 输出 各 个 抽象 类 的 子 类 


程序 的 输出 如 下 : 


<class “enthought.chaco.abstract_mapper.AbstractMapper "> 
<class “enthought.chaco.base_1d_mapper.BaselDMapper "> 
<class ‘enthought.chaco.linear_mapper.LinearMapper' > 
<class 'enthought.chaco.1log_mapper.LogMapper'> 

<class “enthought.chaco.grid_mapper.GridMapper "> 

<class “enthought.chaco.polar_mapper.PolarMapper "> 


<class “enthought.chaco.abstract_data_range.AbstractDataRange "> 
<class “enthought.chaco.base_data_range.BaseDataRange "> 

<class “enthought.chaco.data_range_1d.DataRangelD '> 

<class “enthought.chaco.data_range_2d.DataRange2D '> 


<class “enthought.chaco.abstract_data_source.AbstractDataSource "> 
<class "enthought.chaco.array_data_source.ArrayDataSource "> 

<class “enthought.chaco.point_data_source.PointDataSource "> 

<class “enthought.chaco.grid_data_source.GridDataSource > 

<class “enthought.chaco.image_data.ImageData > 

<class “enthought.chaco.multi_array_data_source.MultiArrayDataSource "> 


在 每 个 类 的 源 程序 中 都 有 详细 的 使 用 说 明 ， 相 信 读 者 在 掌握 了 本 节 介绍 的 结构 关系 之 后 ， 
很 容易 通过 阅读 程序 中 的 文档 掌握 它们 的 用 法 。 


8.2.3 ”编辑 绘图 属性 


绘图 组 件 都 从 HasTrait 类 继承 ， 因 此 它们 的 属性 都 是 Trait 属性 ， 我 们 可 以 使 用 TraitsUI 
为 这 些 属 性 在 界面 中 生成 编辑 控件 。 下 面 的 程序 演示 了 这 一 过 程 ， 效 果 如 图 8-7 所 示 。 


办 chaco_app_example.py 
。 使 用 TraitsUI 界面 编辑 组 件 的 属性 


from enthought.chaco.api import marker trait 
class ScatterPlotTraits(HasTraits): 

plot = Instance(Plot) 

data = Instance(ArrayPlotData) 

color = Color("blue") 

marker = marker trait ©@ 


traits_ view = View( 
Group(Item('color', label="Color"), 
Item( 'marker', label="Marker"), 
Item('object.line.marker_size', label="Size"), © 
Item('plot', editor=ComponentEditor(), show_label=False), 
orientation = "vertical"), 
width=866，height=666，resizable=True，title="Chaco Plot") 


def _init_ (self, **traits): 
super(ScatterplotTraits, self)._init (**traits) 
x = np.linspace(-14，14，166) 
y = np.sin(x) * x**3 
data = ArrayPlotData(x = x, y = y) 
plot = Plot(data) 


self.line = plot.plot(("x", "y"), type="scatter", color="blue")[6] © 
self.plot = plot 
self.data = data 


def _color_changed(self): 
self.line.color = self.color 


def marker_changed(self): 
self.line.marker = self.marker 


if _name__ == "| 
p= ScatterPlotTraits() 
p.configure traits() 
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图 8-7 带 属 性 编辑 器 的 Chaco 绘图 界面 


ScatterPlotTraits 类 中 定义 了 4 个 Trait 属性 , 其 中 两 个 是 我 们 已 经 熟知 的 plot 和 data 属性 ， 
而 color 和 marker 属性 分 别 用 来 修改 曲线 的 颜色 和 散 列 点 的 形状 。@marker 属性 的 类 型 为 
marker trait，marker_trait 是 在 Chaco 库 中 定义 的 一 个 Trait 类 型 ， 它 将 散 列 点 的 形状 名 映射 到 
与 其 对 应 的 类 ,我 们 为 这 些 属性 定义 了 事件 处 理 方法 , 当 它 们 的 值 改变 时 会 调用 _color_changed0 
和 _marker_changed0。 在 这 两 个 事件 处 理 方法 中 通过 修改 line 的 属性 设置 曲线 的 绘图 属性 。 

@line 属性 保存 plot0 所 返回 的 列表 中 的 第 一 个 元 素 ， 也 就 是 与 图 中 曲线 相对 应 的 LinePlot 
对 象 。 也 可 以 不 保存 返回 值 ， 直 接 使 用 前 面 介 绍 的 components 或 plots 属性 来 获得 它 。 例 如 可 
以 用 “plot.plots["plot0"]” 获 取 此 LinePlot 对 象 。"plot0" 是 系统 自动 为 曲线 所 起 的 名 字 。 注 意 : 
在 ScatterPlotTraits 类 中 并 没有 预先 定义 line 属性 ， 它 是 在 ”init 0 中 动态 添加 的 Trait 属性 。 

四 也 可 以 直接 在 界面 中 为 LinePlot 对 象 的 属性 创建 编辑 控件 , 省 去 先 在 ScatterPlotTraits 类 
中 定义 Trait 属性 ， 然 后 进行 事件 处 理 的 步骤 。"object" 代 表 拥有 此 视图 的 ScatterPlotTraits 对 象 ， 
"line" 是 用 来 保存 LinePlot 对 象 的 属性 名 ， 而 "marker_size" 是 LinePlot 对 象 的 属性 名 ， 用 来 设置 
散 列 点 的 大 小 。 


8.2.4 容器 (Containen) 


在 Plot 的 父 类 列表 中 有 OverlayPlotContainer 类 ， 它 将 components 属性 中 的 所 有 组 件 重 又 
在 一 起 进行 显示 ， 因 此 Plot 对 象 可 以 显示 多 条 曲线 。 除 此 之 外 ,在 Chaco 库 中 还 提供 了 几 种 容 
器 ， 完 整 的 容器 列表 如 下 : 

e OverlayPlotContainer: 将 多 个 组 件 进行 重 又 显示 的 容器 。 

e HPlotContainer: 横向 排列 的 容器 。 

e VPlotContainer: 竖 向 排列 的 容器 。 

e GridPlotContainer: 按照 网 格 排列 的 容器 。 


下 面 的 例子 使 用 各 种 容器 创建 一 个 布局 比较 复杂 的 多 子 图 图 表 ， 效 果 如 图 8-8 所 示 。 程 序 


和 前 面 的 例子 类 似 ， 因 此 我 们 只 分 析 其 中 创建 图 表 部 分 的 代码 。 


# chaco_containers.py 
守 二 ” 使 用 各 种 容器 制作 多 子 图 图 表 
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图 8-8 使 用 各 种 容器 制作 的 多 子 图 图 表 


p1 = Plot(data，padding=36) 
p1.plot(("x"，"y")，type="scatter"，color="blue") 
p1.plot(("x", "y"), type="line", color="blue") 

p2 = Plot(data, padding=38) 

p2.plot(("x", "y"), type="line", color="blue") 

p2.set(bounds = [266，166]，position = [798,150], © 

bgcolor = (80.9,0.9,0.9), unified draw=True, resizable="") 

p3 = Plot(data, padding=30) 

p3.plot(("x", "y"), type="line", color="blue", line_ width=2.6) 
p4 = Plot(data, padding=36) 

p4.plot(("x", "y"), type="scatter", color="red", marker="circle") 
c1 = OverlayPlotContainer(p1, p2) © 

c1.fixed_preferred_size = p3.get_ preferred size() © 

c2 = HPlotContainer(c1, p3) @ 

c3 = VPlotContainer(p4, c2) © 

self.plot = c3 
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首先 ，p1、p2、p3 和 p4 是 4 个 Plot 对 象 。cl 是 一 个 OverlayPlotContainer 容器 ，c2 是 一 
个 HPlotContainer 容器 ，c3 是 一 个 VPlotContainer 容器 。 各 个 Plot 对 象 和 容器 所 对 应 的 显示 区 
域 已 经 在 图 8-8 中 标 出 。 每 个 组 件 对 象 都 有 一 个 padding 属性 设置 其 边 距 ， 为 了 让 子 图 的 排列 
更 紧凑 一 些 ， 我 们 在 创建 Plot 对 象 时 设置 它们 的 边 距 为 30 个 像素 。 也 可 以 使 用 padding _left、 
padding right、padding top 和 padding bottom 属性 分 别 设置 左右 上 下 4 个 边 距 。 

@ 使 用 重 释 容器 cl 将 pl 和 p2 两 个 Plot 对 象 重 又 显示 。@ 通 过 设置 p2 对 象 的 position 属 
性 和 bounds 属性 , 指定 它 在 容器 cl 中 的 显示 区 域 . 为 了 让 p2 不 自动 调节 自己 的 大 小 , 还 需要 
设置 其 resizable 属性 为 空 字符 串 。 此 外 ， 通 过 bgcolor 属性 指定 p2 的 背景 颜色 ， 并 指定 
unified_draw 属性 为 True。 绘图 对 象 p2 的 unified_draw 属性 为 True， 表 示 它 将 作为 一 个 整体 绘 
制 到 容器 cl 的 一 个 绘图 层 (默认 为 'plot 绘 图 层 ) 上 ， 否 则 它 的 不 同 绘图 层 将 分 别 绘制 到 容器 cl 
对 应 的 绘图 层 上 。 所 有 这 些 属性 都 是 Trait 属性 ， 因 此 可 以 通过 set0 设 置 它们 。 


读者 可 以 将 p2 的 unified_draw 属性 修改 为 False， 通 过 观察 绘图 结果 的 变化 ,理解 
可 unified_draw 属性 以 及 绘图 层 的 含义 。 


@ 使 用 横 排 容器 c2 将 容器 cl 和 图 表 p3 横向 排列 ， 容 器 会 根据 各 个 组 件 的 尺寸 自动 调节 
它们 的 大 小 比例 。@ 为 了 让 cl 和 p3 一 样 大 ， 通 过 get_preferred size0 获 得 p3 的 首选 尺寸 ， 并 
赋值 给 cl 的 fxed_preferred size 属性 。 这 样 一 来 , cl 和 p3 的 首选 尺寸 相同 ， 容 器 c2 就 能 让 它 
们 的 尺寸 始终 保持 一 致 。 

@ 最 后 用 竖 排 容器 c3 将 p4 和 c2 竖 向 排列 , 由 于 坐标 原点 在 左下 角 , 因此 p4 在 c2 的 下 方 。 

8-9 显示 了 图 8-8 中 各 个 部 分 之 间 的 关系 。 图 中 ， 灰 色 填 充 和 矩形 表示 容器 ， 而 无 填充 和 矩 
形 表示 图 表 上 的 各 种 绘图 组 件 ， 虚 线 矩 形 表示 列表 。 图 中 只 显示 了 一 个 Plot 对 象 的 内 部 构成 ， 
其 他 的 Plot 对 象 和 它 类 似 。 
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图 8-9 各 个 容器 和 绘图 组 件 之 间 的 关系 


8.3 添加 交互 工具 


Chaco 和 matplotlib 相 比 ， 最 大 的 优点 就 是 它 提 供 了 十 分 丰富 的 交互 工具 。 在 IPython 中 输 
入 下 面 的 语句 ， 可 以 看 到 Chaco 提供 的 所 有 工具 ， 从 工具 的 名 称 能 大 致 猜 出 它们 的 用 途 : 


>>> import enthought.chaco.tools.api as 七 
>>> [x for x in dir(t) if isinstance(getattr(t,x), type)] 
['BetterSelectingZoom', 

"BetterZoom ， 

"BroadcasterTool ' ， 

“DataLabelTool ' ， 

“DataPrinter ， 

“DragTool ， 

“DragZzoom , 


[[ 省 略 ]] 
下 面 看 看 如 何 利用 这 些 工具 为 图 表 添 加 各 种 各 样 的 交互 功能 。 
8.3.1 平移 和 缩放 


平移 和 缩放 是 和 图 表 进行 交互 的 两 个 最 基本 的 工具 , 下 面 的 程序 演示 了 如 何在 图 表 中 添加 
它们 : 


¥ A# chaco_tools_ pan zoom.py 
这 下 添加 平移 和 缩放 功能 


在 Chaco 3.4 中 , DragZoom 工具 存在 一 个 Bug, 会 导致 通过 鼠标 拖 动 进行 缩放 无 法 正 
常 工作 。 读 者 可 以 按照 下 面 的 说 明 进行 修改 。 


用 编辑 器 打开 如 下 文件 : 
site-packages\Chaco-3.4.0-py2.6-win32.egg\enthought\chaco\tools\drag_zoom.py 


在 其 中 DragZoom 类 的 dragging0 方 法 的 最 后 添加 如 下 代码 : 


self.zoom_in_x(zoom x) 
self.zoom_in_y(zoom_y) 

self._prev_x = event.x # <-- 添加 此 行 代码 
self. prev y = event.y # <-- 添加 此 行 代码 
return 
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程序 的 构造 和 前 面 介绍 的 例子 基本 相同 , 我 们 只 针对 增加 的 部 分 进行 说 明 。 首 先 需 要 载 入 
这 些 交互 工具 : 平移 工具 PanTool、 缩 放 工具 ZoomTool 和 拖 动 缩放 工具 DragZoom。 


from enthought.chaco.tools.api import PanTool, ZoomTool, DragZoom 


在 初始 化 方法 _init 0 中 ， 使 用 下 面 的 程序 为 Plot 对 象 添加 交互 工具 : 


plot.tools.append(PanTool(plot)) 

plot.tools.append(DragZzoom(plot, drag_button="right", 
maintain aspect_ratio=False)) 

plot .overlays.append(ZoomTool(plot)) 


每 个 工具 都 需要 知道 自己 所 处 理 的 组 件 对 象 , 这 里 在 创建 工具 对 象 时 ,将 Plot 对 象 作为 第 
一 个 参数 传递 给 它 。PanTool 和 DragZoom 对 象 被 放 入 Plot 对 象 的 tools 列表 ， 而 ZoomTool 对 
象 则 被 放 入 overlays 列表 。 这 是 因为 PanTool 和 DragZoom 对 象 仅 响应 用 户 的 键盘 和 鼠标 事件 ， 
在 界面 上 没有 任何 显示 。 而 ZoomTool 对 象 提供 了 多 种 缩放 功能 ， 用 户 可 以 使 用 它 的 “选择 放 
大 ”功能 ， 选 择 图 表 中 的 一 块 区 域 进行 放大 ， 因 此 它 需要 在 图 表 上 绘制 表示 选择 区 域 的 矩形 ， 
由 于 选区 和 矩形 在 数据 曲线 之 上 显示 ， 因 此 需要 将 它 添加 进 overlays 列表 。 

有 了 PanTool 工具 之 后 , 可 以 在 图 表 中 按 住 鼠 标 左 键 拖 动 以 改变 X-Y 轴 的 显示 范围 。 有 了 
ZoomTool 工具 ， 便 可 以 使 用 鼠标 滚 轴 对 图 表 进 行 缩 放 。 或 者 按 一 下 “z” 键 ， 进 入 “选择 放大 ” 
状态 ， 此 时 光标 变 成 一 个 放大 镜 ， 按 住 鼠 标 左 键 拖 动 可 以 选择 要 放大 的 区 域 ， 松 开 左 键 后 ， 所 
选 的 区 域 将 充满 整个 图 表 。 一 连 串 的 “选择 放大 ”操作 将 会 被 记录 下 来 , 按 “CtltZ” 和 “Ctl+Y” 
可 以 在 历史 选区 之 间 来 回 切 换 。 而 DragZoom 工具 则 可 以 通过 鼠标 的 拖 动 来 实现 X 轴 和 下 轴 
的 单独 缩放 。 

可 以 通过 设置 工具 对 象 的 各 种 Trait 属性 , 自 定义 它们 的 交互 方式 .例如 程序 中 设置 了 DragZoom 
对 象 的 drag_button 和 maintain aspect ratio 属性 。drag_button 属性 指定 拖 动 操作 所 使 用 的 鼠标 
按键 ， 为 了 和 PanTool 工具 的 按键 相 区 别 ， 这 里 设置 为 使 用 鼠标 右键 进行 拖 动 缩放 。maintain_ 
aspect_ratio 属性 为 False， 表 示 X 轴 和 YY 轴 不 需要 保持 一 定 的 比例 ， 可 以 单独 进行 缩放 。 拖 动 
缩放 工具 DragZoom 的 属性 ， 如 表 8-1 所 示 。 


表 8-1 DragZoom 工具 的 属性 


属性 名 说 上 明 
drag button 拖 动用 的 鼠标 按键 : "left"、"middle"、"right" 
speed 拖 动 速度 ， 缺 省 为 10 
maintain aspect ratio 是 否 维持 X-Y 轴 的 比例 ， 默 认为 Tme 
dmag pointer 拖 动 缩放 时 的 鼠标 光标 ， 图 标 默认 为 "magnifier" 
single axis 是 否 只 在 一 个 轴 上 进行 缩放 
axis 缩放 轴 ，single 为 True 时 ，axis 指定 缩放 的 轴 


平移 工具 PanTool 的 属性 如 表 8-2 所 示 。 


表 8-2 PanTool 工具 的 属性 


属 性 名 说 ”了 明 
drag_button 拖 动用 的 鼠标 按键 ; "left"、"middle"、"right" 
speed 拖 动 速度 ， 默 认为 1.0 
constrain 是 否 锁定 拖 动 方向 ， 默 认为 False 
constrain key 锁定 拖 动 的 修饰 键 : None、"shift"、"control"、"alt" 


constrain direction 


锁定 拖 动 方向 : None、"x"、"y" 


Testrict to_data 


是 否 限制 在 数据 范围 之 内 ， 默 认为 False 


通过 drag_button 属性 可 以 指定 进入 平移 状态 的 鼠标 按键 ， 例 如 可 以 将 拖 动 按键 设置 为 中 
键 。 如 果 设 置 constrain key 属性 为 某 个 修饰 键 ， 按 住 此 键 进 行 平移 时 ， 将 只 能 在 X 轴 或 Y 轴 
方向 上 进行 平移 。 也 可 以 设置 constrain 属性 为 True， 并 通过 constrain_direction 属性 设置 拖 动 
方向 ， 这 样 一 来 就 只 能 在 一 个 方向 上 进行 平移 。 

缩放 工具 ZoomTool 的 部 分 属性 如 表 8-3 所 示 。 


属 性 名 
tool mode 
always_on 
always on modifier 
enter zoom key 
drag button 
axXis 
enable wheel 


Wheel zoom step 


表 8-3 ZoomTool 工具 的 部 分 属性 
说 明 

范围 缩放 的 模式 : "box"、"range” 
范围 缩放 模式 是 否 自动 启动 ， 默 认为 False 
进入 范围 缩放 模式 的 修饰 键 
进入 范围 缩放 模式 的 按键 ， 默 认为 "z" 
选择 缩放 范围 的 鼠标 按键 : "left"、"right"、None 
范围 缩放 的 轴 : "index"、"value"。 仅 当 tool mode 为 "range" 时 有 效 
是 否 开启 鼠标 滚 轴 缩放 功能 ， 默 认为 Tme 
鼠标 滚 轴 缩放 的 缩放 速度 ， 默 认为 1 


缩放 工具 提供 了 两 种 缩放 方式 ， 鼠 标 深 轴 缩放 和 范围 缩放 。 而 范围 缩放 又 分 为 矩形 模式 
"box" 和 轴 范 围 模 式 "range" 两 种 。 用 enter_zoom key 属性 指定 的 按键 进入 范围 模式 ， 使 用 
drag_button 属性 指定 的 鼠标 按键 选择 范围 。 如 果 always_on 为 Ture， 用 always_on_modifier 属性 
指定 的 修饰 键 也 可 以 进入 范围 模式 。 此 外 , 还 可 以 通过 pointer、 color、 alpha、 border、 border_size 
等 属性 指定 鼠标 的 光标 以 及 绘制 的 范围 矩形 的 颜色 、 透 明度 、 边 框 及 边框 粗细 。 例 如 下 面 的 程 
序 为 图 表 添 加 一 个 在 X 轴 上 进行 放大 的 工具 ， 按 住 Ctrl 修饰 键 可 进入 X 轴 缩 放 模 式 : 


plot.overlays.append(ZoomToo1(plot，tool_mode="range"，axis = "index", 


always_on=True, always_on_modifier="control")) 
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8.3.2 选取 范围 


Chaco 提供 了 许多 对 数据 进行 选择 的 工具 。 下 面 的 程序 使 用 范围 选择 工具 RangeSelection， 
制作 了 一 个 在 X 轴 上 进行 动态 缩放 的 交互 式 界面 ， 效 果 如 图 8-10 所 示 。 用 鼠标 右键 在 上 方 图 
表 中 选择 一 个 范围 ， 下 方 图 表 中 将 显示 所 选择 的 部 分 ， 以 便 用 户 观 察 数 据 的 细节 部 分 。 


g A chaco tools range select.py 
完 _# 用 范围 选择 工具 观察 数据 的 细节 


?和 |] 
| 
"| , | _ 串 


5 0 


8-10 用 范围 选择 工具 观察 数据 的 细节 


from enthought.chaco.tools.api import RangeSelection, RangeSelectionOverlay 


首先 从 工具 库 中 载 入 RangeSelection 和 RangeSelectionOverlay。RangeSelection 负责 响应 鼠 
标 事件 ， 进 行 范围 选择 ， 而 RangeSelectionOverlay 则 负责 将 选区 绘制 到 图 表 之 上 。 


self.plot1 = plot1 = Plot(data, padding=25) 

self.linel = linel = plot1.plot(("x", "y"), type="line")[6] © 
self.select tool = select tool = RangeSelection(linel) @ 
linel.tools.append( select tool ) 

select tool.on trait change(self._selection changed, "selection") © 
line1.overlays.append(RangeSelectionOverlay(component=line1)) @ 
self.plot2 = plot2 = Plot(data, padding=25) 

plot2.plot(("x", "y"), type="line")[8] 

self.plot = VPlotContainer(plot2, plot1) 


上 面 是 _init 0 中 进行 图 表 配置 的 部 分 。 我 们 创建 了 两 个 Plot 对 象 一 -plotl 和 plot2， 然 
后 使 用 一 个 VPlotContainer 对 象 将 它们 垂直 排列 。@ 调 用 plotl 的 plot0 进 行 绘图 ， 并 用 linel 保 
存 返 回 的 LinePlot 对 象 。@ 为 linel 添加 RangeSelection 工具 ， 由 于 RangeSelection 工具 只 负责 


事件 处 理 ， 因 此 将 它 添加 到 linel 的 tools 列表 中 。@ 为 选择 工具 select tool 的 selection 属性 添 
加 事件 监听 方法 。 当 用 户 通 过 界面 修改 了 选择 范围 时 ， 选 择 工具 的 selection 属性 将 发 生变 化 ， 
从 而 调用 _selection_changed0 方 法 。@ 在 linel 的 overlays 列表 中 添加 一 个 RangeSelectionOverlay 
对 象 ， 它 将 显示 用 户 所 选择 的 范围 。 注 意 ， 这 里 是 将 两 个 工具 添加 进 linel 对 象 而 不 是 plotl 对 
象 ， 稍 后 将 对 此 进行 解释 。 


def _selection changed(self): 
selection = self.select tool.selection 
if selection != None: 
self.plot2.index_range.set_ bounds(*selection) 
else: 
self.plot2.index_range.reset() 


当选 区 发 生变 化 时 ，_selection_changed0 方 法 将 被 调用 。 它 根据 当前 的 选择 范围 ， 调 用 
plot2.index_range 的 set_bounds() 或 reset0 方 法 ， 修 改 下 方 图 表 中 X 轴 的 显示 范围 。 

读者 也 许 会 有 疑问 : RangeSelectionOverlay 对 象 是 如 何 知道 RangeSelection 对 象 的 选区 发 
生变 化 的 ? 从 程序 中 ， 我 们 找 不 到 在 二 者 之 间 建 立 联系 的 代码 。 它 们 之 间 的 信息 交互 不 是 直接 
进行 的 , 而 是 通过 它们 所 共 知 的 linel 对 象 作 为 中 间 代 理 间接 地 进行 交互 。 下 面 我 们 通过 IPython 
分 析 一 下 它们 是 如 何 进行 交互 的 。 

首先 ，linel 是 一 个 LinePlot 对 象 ， 它 有 index 和 value 两 个 属性 ， 分 别 保存 曲线 的 X-Y 轴 
数据 ， 它 们 都 是 ArrayDataSource 对 象 : 


>>> p.linel 

<enthought.chaco.lineplot.LinePlot object at 8x6C1684E6> 

>>> p.linel.index 

<enthought.chaco.array_data_source.ArrayDataSource object at 8x6C168336> 


ArrayDataSource 对 象 有 一 个 metadata 属性 ， 用 来 存储 对 数据 进行 描述 的 数据 ， 我 们 称 之 
为 元 数据 。metadata 属性 是 一 个 类 似 于 字典 的 TraitDictObject 对 象 : 


>>> p.linel.index.metadata.keys() 

['selection masks', "annotations', 'selections'] 

>>> p.linel.index.metadata["selections"] 
(-127.95188722891567，-68.963855421686759) 

>>> p.select tool.selection 

(-127.95188722891567，-68.963855421686759) 

>>> p.linel.index.metadata["selection _masks"] 

[array([False, False, False, False, False, False, False, False, False, ...])] 


不 同 的 工具 会 在 metadata 属性 中 添加 不 同 的 元 数据 , 例如 selection_masks' 和 'selections' 都 是 
RangeSelection 对 象 添加 的 元 数据 。 其 中 ，'selections' 表 示 选 区 范围 ， 而 'selection_masks' 是 一 个 
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布尔 数组 的 列表 ， 它 表示 数据 中 的 每 个 数值 是 否 在 选区 之 内 。 

RangeSelection 对 象 的 工作 就 是 响应 用 户 的 操作 , 并 对 metadata 属性 中 的 元 数据 进行 更 新 。 
而 RangeSelectionOverlay 对 象 则 监视 metadata 属性 中 名 为 'selections' 的 元 数据 的 变化 , 用 它 的 最 
新 值 在 图 表 上 绘制 选区 。 下 面 的 程序 获得 它 所 监视 的 元 数据 名 ， 由 于 默认 值 就 是 'selections'， 
此 无 需 对 其 进行 配置 。 如 果 读 者 自己 编写 了 工具 类 来 修改 别 的 元 数据 , 可 以 通过 metadata_name 
属性 指定 与 它 相关 的 元 数据 名 。 


>>> p.linel.overlays[6].metadata_name 
“selections 


区 域 选 择 工 具 也 有 很 多 Trait 属性 ， 例 如 ， 如 果 将 RangeSelection 和 RangeSelectionOverlay 对 
象 的 axis 属性 都 设置 为 value'， 那 么 它们 将 对 linel.value 的 'selections' 元 数据 进行 处 理 ， 从 而 实 
现在 立轴 上 的 选区 选择 。 

由 于 Plot 对 象 是 一 个 容器 ， 它 本 身 没 有 index 和 value 等 属性 ， 因 此 我 们 不 能 为 Plot 对 象 
添加 区 域 选择 工具 。 整 个 系统 的 构造 如 图 8-11 所 示 。 


Plot 


L 
components[0] 
让 


LinePlot 


tookt0i ndex avertays[D] 
* 
Rangeselection i— ArrayDataSource 一 一 一 全 RangeSelectionOverlay 


metadata 
y 


slections, selecion_masks 一 步 TraitDictObject 一 selecsons, selaction_masks 
图 8-11 选择 工具 通过 元 数据 传递 信息 


8.3.3 选取 数据 点 


使 用 ScatterInspector 和 ScatterInspectorOverlay 工具 可 以 对 图 表 中 的 单个 数据 点 进行 选取 。 
图 8-12 是 使 用 它们 对 数据 进行 选取 的 一 个 例子 。 我 们 可 以 使 用 绿色 或 红色 两 种 颜色 的 选择 工具 
对 数据 点 进行 选择 。 如 果 某 个 数据 点 同时 被 两 个 工具 选中 , 那么 它 的 颜色 为 红色 和 绿色 的 混合 。 
两 个 工具 所 选择 的 数据 点 分 别 用 两 个 列表 控件 显示 。 下 面 让 我 们 分 析 一 下 这 个 程序 。 


有 A chaco_tools_point select.py 
污 二 使 用 点 选择 工具 选择 数据 点 


一 


图 8-12 选取 数据 点 ， 并 标 为 红色 和 绿色 


from enthought.chaco.api import ScatterInspectorOverlay 
from enthought.chaco.tools.api import ScatterInspector 


首先 载 入 ScatterInspector 和 ScatterInspectorOverlay， 注 意 它 们 的 载 入 位 置 不 同 。 和 前 面 介 
绍 的 RangeSelection 和 RangeSelectionOverlay 一 样 ，ScatterInspector 负责 响应 鼠标 事件 ， 将 用 
户 选 择 的 点 写 入 元 数据 中 ，ScatterInspectorOverlay 则 根据 元 数据 在 overlays 层 绘制 被 选中 的 点 
的 标识 。 

Colors = { 
"green":(0, 1, 0, 0.5), 
"ped"s(1 90, 0, 05) 

} 


接 下 来 定义 了 一 个 颜色 字典 ， 以 颜色 名 为 键 ， 而 值 是 颜色 值 。 将 颜色 的 透明 度 设置 为 0.5， 
这 样 一 来 ， 当 两 个 颜色 倒 加 时 便 能 够 混合 出 别 的 颜色 。 


class PointSelectionDemo(HasTraits): 
color = Enum(Colors.keys()) 
green_selection = List() 
red_selection = List() 
plot = Instance(Plot) 
data = Instance(ArrayPlotData) 


PointSelectionDemo 类 有 4 个 Trait 属 性 .其 中 ,color 属 性 用 于 设置 选择 工具 ，green_selection 
和 red_selection 属性 用 于 显示 被 两 个 选择 工具 选中 的 数据 。 接 下 来 跳 过 视图 定义 部 分 ， 直 接 查 
看 _init_0 中 设置 图 表 的 部 分 : 


plot = Plot(data，padding=25) 
self.scatter = scatter = plot.plot(("x"，"y")，type="scatter"，marker_size=4)[6] © 
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self.select tools = {} 
for i, c in enumerate(Colors.keys()): 
hover_name = "hover %s" %c 
selection name = "selections %s"%c 
self.select tools[c] = ScatterInspector(scatter, ©@ 
hover_metadata_name=hover_name, 
selection metadata name=selection name) 
scatter.overlays.append(ScatterInspectorOverlay(scatter, © 
hover_metadata_name = hover_name， 
selection_metadata_name=selection_name， 
hover_color = "transparent", 
hover_outline color = cy 
hover_marker_size = 6， 
hover_line width = 1, 
Selection_color = Colors[c], 
)) 
scatter.active tool = self.select tools[self.color] @ 
scatter.index.on_trait_change(self.selection_changed, "metadata_changed ') © 
self.plot = plot 
self.data = data 


人 @ 由 于 plot0 的 type 参数 为 "scatter"， 因 此 它 返 回 一 个 ScatterLine 对 象 的 列表 。@ 在 循环 体 
中 创建 ScatterInspector 对 象 , 并 设置 它 的 hover_ metadata name 和 selection_metadata_name 属性 ， 
这 两 个 属性 决定 它 所 使 用 的 元 数据 名 称 。 当 鼠标 移动 到 某 个 数据 点 之 上 时 ， 将 在 元 数据 字典 中 
添加 一 个 键 为 hover metadata name 的 元 素 ; 而 选择 的 数据 将 存放 在 元 数据 字典 中 以 
selection_metadata_name 为 键 的 列表 中 。 这 里 使 用 循环 创建 了 两 个 ScatterInspector 对 象 ， 它 们 
对 应 的 元 数据 名 分 别 为 "hover_green"、"hover_red"、"selections_green" 和 "selections_red"。 所 创 
建 的 ScatterInspector 对 象 并 不 直接 存放 到 scatter 对 象 的 tools 列表 中 ,而 是 先 用 一 个 字典 select_ 
tools 将 它们 保存 起 来 。 

四 创建 ScatterInspectorOverlay 对 象 ， 将 它 的 两 个 用 来 定义 元 数据 名 的 属性 设置 成 和 
ScatterInspector 对 象 一 样 。ScatterInspectorOverlay 对 象 有 许多 Trait 属性 用 来 设置 其 绘图 效果 。 
以 “hover ”开头 的 属性 用 于 设置 名 为 hover_metadata_name 的 元 数据 的 显示 效果 ; 而 以 

“selection ”开头 的 属性 则 用 于 设置 名 为 selection_metadata_name 的 元 数据 的 显示 效果 。 

下 面 在 Python 中 查看 由 这 些 工具 产生 的 元 数据 。 在 IPython 中 运行 程序 之 后 ， 分 别 用 红 
色 和 绿色 选择 工具 在 图 表 中 选择 几 个 点 ， 并 让 鼠标 停留 在 某 个 数据 点 之 上 。 按 Alt+Tab 切换 回 
IPython， 并 运行 下 面 的 语句 : 


>>> p.scatter.index.metadata 

{'annotations': []， 
"hover_red': [73], 
'selections': [], 


"selections_green' : [15, 92, 13, 95, 67, 11], 
'selections_red': [95, 67, 99, 17, 75, 66]} 


这 表示 红色 选择 工具 的 鼠标 正在 下 标 为 73 的 数据 点 之 上 , 并 上 且 选择 了 下 标 为 95、67、99、 
17、75、66 的 数据 点 。 绿 色 选 择 工具 则 选择 了 下 标 为 15、92、13、95、67、11 的 数据 点 。 其 
中 ,下 标 为 95 和 67 的 数据 点 同时 被 两 个 工具 选中 。 

@ 我 们 不 能 将 两 个 ScatterInspector 对 象 都 添加 进 scatter 的 tools 列表 中 ， 因 为 它们 会 同时 
响应 鼠标 事件 。 只 能 将 被 选中 的 那个 选择 工具 设置 给 scatter 的 active tool 属性 。 通 过 修改 
active tool 属性 ， 可 以 使 用 不 同 的 选择 工具 响应 鼠标 事件 。 因 此 ， 当 通过 界面 上 的 单 选 按钮 修 
改 PointSelectionDemo 对 象 的 color 属性 时 ， 我 们 需要 修改 ScatterPlot 对 象 的 active tool 属性 


def _color_changed(self) : 
self.scatter.active tool = self.select tools[self.color] 


全 当 scatter.index 的 元 数据 发 生变 化 时 ， 将 会 触发 其 metadata_changed 事件 ， 通 过 添加 处 
理 此 事件 的 方法 ， 可 以 在 用 户 的 程序 中 监视 元 数据 的 变化 。 由 于 scatter value 和 scatter index 的 
元 数据 会 同时 发 生变 化 ， 因 此 只 需要 处 理 其 中 的 一 个 事件 即 可 。 当 鼠标 移入 、 移 出 或 选中 某 个 
数据 点 时 ， 元 数据 都 会 发 生变 化 ， 从 而 调用 selection_changed0 方 法 。 


def selection changed(self): 
x = self.scatter.index.get data() © 
y = self.scatter.value.get data() @ 
metadata = self.scatter.index.metadata 
selection = metadata.get("selections_green", []) © 
self.green_selection = ["%d, (%f, %f)" % (s, x[s], y[s]) for s in selection] 
selection = metadata.get("selections red", []) @ 
self.red_selection = ["%d, (%f, %f)" % (s, x[s], y[s]) for s in selection] 


在 selection changed0 中 , @ 和 @ 分 别 获得 表示 数据 点 的 X-Y 轴 坐 标 值 的 数组 , @ 和 @ 分 别 
使 用 名 为 "selections_green" 和 "selections_red" 的 元 数据 从 数据 数组 中 获得 被 选中 的 数据 点 的 
坐标 。 


8.3.4” 套 索 工具 


使 用 套 索 工具 可 以 用 鼠标 绘制 一 个 任意 形状 的 选区 ， 并 选取 落 入 此 区 域 中 的 数据 点 。 下 面 
的 程序 演示 如 何 使 用 套 索 工 具 选 择 数据 ， 效 果 如 图 8-13 所 示 。 


5 # chaco_tools_lasso_selection.py 
总 用 套 索 工具 选择 数据 点 
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图 8-13 用 套 索 工具 选择 数据 点 


from enthought.chaco.api import Lasso0verlay 
from enthought.chaco.tools.api import LassoSelection 


套 索 工具 也 分 为 两 部 分 : LassoSelection 对 象 对 用 户 的 鼠标 操作 进行 处 理 ，LassoOverlay 对 
象 则 显示 用 户 所 绘制 的 套 索 区 域 。 

在 _init_0 中 ,首先 创建 数据 对 象 data， 并 为 其 添加 名 为 "xx"、"y"、"x2"、"y2" 的 4 个 数组 。 
我 们 省 略 这 段 程序 ， 直 接 查看 对 Plot 对 象 进行 设置 的 部 分 : 


plot1 = Plot(data，padding=16) 

scatter_plot1 = plot1.plot(("x", "y"), type="scatter", marker="circle”", 
color="blue")[8] 

self.1asso = LassoSelection(scatter plot1, incremental_select=True, © 
selection_datasource=scatter_plot1.index) 

self.1asso.on_trait_change(self._selection_changed， 'selection changed'’) @ 

scatter_plot1.tools.append(self.1asso) 

scatter_plot1.overlays.append(LassoOverlay(scatter_plot1, 
lasso_selection=self.lasso)) © 

plot2 = Plot(data, padding=10) 

plot2.index_range = plot1.index_range 

plot2.value_range = plot1.value_range 

plot2.plot(("x2", "y2"), type="scatter", marker="circle", color="red") 


@ 创 建 处 理 鼠 标 操作 的 LassoSelection 对 象 。 incremental_select 参数 为 True, 表示 当 套 索 区 
域 改变 时 ， 将 会 立即 修改 其 selection 属性 。 如 果 为 False， 只 有 在 松 开 鼠标 按键 完成 选区 时 才 
更 新 selection 属性 。LassoSelection 对 象 和 前 面 介 绍 的 工具 有 所 不 同 ， 需 要 通过 selection 
datasource 属性 指定 与 之 相关 的 数据 对 象 。 此 数据 对 象 中 名 为 "selection" 的 元 数据 是 一 个 遮 单 数 
组 ， 其 中 值 为 1 的 元 素 表 示 数 据 对 象 中 对 应 下 标的 数据 点 被 套 索 选 中 ， 为 0 表示 没有 被 选中 。 
因为 LassoSelection 对 象 的 selection_ changed 事件 设置 事件 处 理 方法 ， 当 selection 属性 改变 时 ， 
selection_ changed 事件 将 会 被 触发 。 


罩 创 建 显 示 套 索 区 域 的 LassoOverlay 对 象 。 由 于 LassoSelection 对 象 不 在 数据 对 象 的 元 数 
据 中 存储 表示 套 索 区 域 的 多 边 形 数据 ,因此 需要 设置 LassoOverlay 对 象 的 lasso_selection 属性 ， 
指定 与 之 对 应 的 LassoSelection 对 象 。 


def _selection changed(self): 
index = np.array(self.lasso.selection datasource.metadata["selection"], 
dtype=np.bool) 
self.data["x2"] = self.data["x"][index] 
self.data["y2"] = self.data["y"][index] 


最 后 在 套 索 工具 的 事件 处 理 方法 中 ,将 元 数据 中 的 遮 单 数组 转换 为 布尔 数组 ， 并 使 用 它 分 

别 对 名 为 "x" 和 "y" 的 数组 进行 下 标 选 择 , 更 新 名 为 "x2"、"y2" 的 数组 。 由 于 右 侧 的 Plot 对 象 和 名 

"x2" 和 "y2" 的 数据 相关 联 ， 因 此 当 它们 改变 时 ， 图 8-13 中 右 侧 的 图 会 自动 更 新 。 整 个 系统 的 
构造 如 图 8-14 所 示 ( 见 文 前 彩 插 )。 
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图 8-14 ”使 用 套 索 工具 时 的 系统 构造 


8.4 二 次 开发 


为 了 开发 自己 的 Chaco 工具 ， 需 要 了 解 Chaco 的 内 部 结构 。Chaco 内 部 使 用 了 Enthought 公 
司 发 布 的 Enable、Kiva、Traits、TraitsUI 等 几 个 扩展 库 ， 它 们 之 间 的 依存 关系 如 图 8-15 所 示 。 

Chaco 是 制作 二 维 交 互 式 图 表 的 绘图 库 ， 其 中 定义 了 各 种 类 型 的 图 表 类 、 表 示 图 表 数 据 的 
数据 源 类 ， 以 及 表示 数据 轴 、 网 格 的 图 表 工具 类 。 

Chaco 的 所 有 绘图 类 都 建立 在 Enable 库 的 Component 类 基础 之 上 。Component 类 向 Chaco 
提供 了 一 个 统一 的 管理 绘图 对 象 的 平台 , 而 Enable 库 中 的 ComponentEditor 则 为 后 台 GUI 库 提 
供 了 一 个 可 以 进行 绘图 的 控件 。 它 使 我 们 可 以 将 图 表 嵌 入 到 由 wxPython 或 PyQt4 制作 的 界面 
程序 中 。 
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图 8-15 ”Chaco 使 用 的 库 


Kiva 提供 了 一 个 统一 的 绘图 API 接口 ， 它 可 以 使 用 多 种 图 形 绘制 库 绘 制图 形 。 对 于 每 个 
图 形 库 , Kiva 都 定义 了 一 个 GraphicsContext 类 以 封装 所 有 的 绘图 细节 。Enable 通过 GraphicsContext 
在 Component 上 绘制 图 形 。 

在 Chaco 和 Enable 中 ， 大 多 数 类 都 从 HasTraits 继承 ， 它 们 依靠 Traits 和 TraitsUI 库 提供 
的 强大 功能 ， 实 现 各 种 复杂 的 逻辑 处 理 。 


8.4.1 用 Kiva 库 在 数组 上 绘图 


Kiva 库 可 以 单独 用 来 绘图 , 还 可 以 在 多 种 后 台 上 进行 绘图 , 例如 wxPython、PyQt4、PDF、 
SVG 等 等 。 在 Python(x,y) 的 安装 目录 下 能 够 找到 一 些 使 用 Kiva 绘图 的 例子 : 


Cc:\pythonxy\doc\Enthought Tool Suite\Enable\kiva 


Kiva 还 能 直接 在 NumPy 数组 上 进行 绘图 ， 下 面 的 例子 演示 了 这 个 功能 ， 效 果 如 图 8-16 
所 示 ( 见 文 前 彩 插 )。 


图 8-16 用 Kiva 在 数组 上 绘制 星星 图 案 


- A chaco_kiva_stars.py 
本; 泛 Kiva 在 数组 上 绘制 星星 图 案 


import numpy as np 
from enthought.kiva.image import GraphicsContext 


为 了 在 数组 上 进行 绘图 ， 需 要 从 Kiva 库 的 image 模块 载 入 GraphicsContext 类 ， 它 提供 在 
内 存 中 的 图 像 (数组 ) 上 绘制 图 案 的 各 种 方法 。 


img = np.zeros((566,866,4)，dtype=np.uint8) © 
img[:,:,:3] = 8 # 全 黑 图 像 
img[:,:,3] = 255 
gc = GraphicsContext(img) © 
for i in range(1666) : 
randint = np.random.randint 
rand = np.random.rand 
draw_star(gc，randint(868)，randint(566)，randint(5,16)， © 
(rand(),rand(),rand())，rand()*2*np.pi，randint(3,9)，rand()*8.6+6.1) 
gc.save("stars.png") @ 


目前 ，GraphicsContext 类 只 支持 在 3 通道 或 4 通道 的 图 像 数组 上 进行 绘图 。 使 用 单 通 
道 的 图 像 数组 虽然 可 以 创建 GraphicsContext 对 象 ， 但 是 却 无 法 在 它 上 面 进行 绘图 。 


@ 创 建 一 个 形状 为 (500, 800, 4) 的 无 符号 单字 节 整 数 数组 img。 如 果 把 此 数组 当做 一 幅 图 像 ， 
那么 第 0 轴 的 长 度 500 就 是 图 像 的 高 度 ， 第 1 轴 的 长 度 800 则 是 图 像 的 宽度 ， 第 2 轴 的 长 度 4 
表示 图 像 的 颜色 有 4 个 通道 一 - 红 、 绿 、 蓝 和 alpha 通道 。 使 用 数组 img 创建 一 个 GraphicsContext 
对 象 gs， 通 过 调用 ge 的 绘图 方法 在 数组 上 进行 绘图 。 在 接 下 来 的 循环 中 ， 调 用 draw_star0 在 
gc 上 绘制 各 种 颜色 的 星星 图 案 。@ 最 后 调用 gc 的 save0 方 法 将 数组 保存 成 PNG 图 像 文件 。 下 
面 是 绘制 星星 的 程序 : 


def star_polygon(x, y, r, theta, n, s): © 
angles = np.arange(0, 2*np.pi+2*np.pi/2/n, 2*np.pi/2/n) + theta 
xs =r* np.cos(angles) 
ys = r * np.sin(angles) 
xs[1::2] *= s 
ys[1::2] *= s 
xs += X 
ys += y 
return np.vstack([xs，ys]).T 


def draw_star(gc，x，y，r，c，theta，n，s): © 
gc.save_state() 
gc.set_antialias(True) 
gc.set_stroke_color(c + (6.8,)) 
gc.set_fill_ color(c + (8.4,)) 
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gc.lines(star_polygon(x, y, r, theta, n, s)) 
gc.draw_path() 
gc.restore_state() 


@star polygon0 通 过 一 系列 的 参数 ， 计 算出 表示 星星 图 案 的 多 边 形 的 顶点 坐标 。 其 中 : x 
和 y 是 多 边 形 的 中 心 坐标 ; T 是 中 心 到 多 边 形 顶 点 的 距离 ， 也 就 是 星星 的 大 半径 ;theta 是 多 边 
形 顶 点 的 起 始 弧度 ; n 是 星星 顶 角 的 个 数 ; s 是 星星 小 半径 和 大 半径 的 比例 。 它 返回 的 是 一 个 
描述 封闭 多 边 形 项 点 坐标 的 形状 为 QN+1, 2) 的 二 维 数组 ， 其 中 N 是 多 边 形 的 顶点 数 。 例 如 ， 五 
角 星 有 10 条 边 ， 因 此 数组 的 形状 为 (11.2)， 其 中 首尾 两 个 点 的 坐标 是 完全 一 样 的 。 

@draw star0 在 gc 上 绘制 星星 ， 它 调用 了 gc 的 一 系列 方法 来 完成 绘制 工作 。 绘 图 的 一 般 
步骤 如 下 : 

调用 save_state0 保 存 当 前 的 绘图 状态 ， 绘 图 状态 包括 当前 的 颜色 、 线 型 、 粗 细 等 许多 与 绘 
图 相关 的 配置 。 

调用 一 系列 set_*0 方 法 设置 各 种 绘图 属性 , 例如 set_antialias0 配 置 反 锯齿 效果 、set_stroke_ 
color0 配 置 线条 颜色 、set_fill_color0 配 置 填充 颜色 。 

调用 各 种 绘图 方法 创建 图 案 的 路 径 , 例如 : lines0 创 建 多 条 连续 的 直线 , move_to0、 line_to0 
创建 单条 直线 ，arc0 创 建 圆 弧 等 。 调 用 这 些 方法 时 并 没有 真正 绘图 ， 而 是 在 gc 内 部 的 路 径 对 象 
中 添加 数据 。 

调用 draw_path0 进 行 绘图 ， 它 使 用 gc 的 路 径 对 象 和 当前 的 绘图 属性 在 数组 上 绘图 。 绘 图 
完成 之 后 它 会 自动 清空 路 径 对 象 ， 以 便 创 建 下 一 个 路 径 。draw_path0 会 对 路 径 进 行 填充 并 进行 
描 边 ， 而 组 _path0 只 进行 填充 ，stroke_path0 只 进行 描 边 。 通 过 gc，get_path0 可 以 获得 路 径 对 象 ， 
而 通过 路 径 对 象 的 _vertices0 可 以 获得 路 径 的 顶点 信息 。 

最 后 调用 restore_state0， 恢 复 到 调用 save_state0 之 前 的 绘图 状态 。 


Kiva 库 缺乏 文档 ， 如 果 读 者 想 深入 了 解 各 种 绘图 函数 的 用 法 ， 可 以 在 Chaco 的 目录 
下 对 所 有 的 Python 文件 搜索 “gc”。 这 样 能 搜索 到 Chaco 库 的 程序 中 使 用 GraphicsContext 
对 象 绘图 的 程序 。 


8.4.2 Enable 库 的 组 件 


Chaco 的 所 有 绘图 类 都 建立 在 Enable 库 的 Component( 组 件 ) 类 的 基础 之 上 。 我 们 也 可 以 直 
接 使 用 Component 制作 交互 式 绘图 程序 。 下 面 是 一 个 实例 ， 图 8-17 是 它 的 界面 截图 。 界 面 的 
用 法 如 下 : 

。 通过 窗口 上 方 的 工具 栏 可 以 修改 星星 的 项 角 数 和 颜色 。 

。 按 住 鼠 标 左 键 并 拖 动 可 绘制 星星 。 

。 将 鼠标 移动 到 某 个 星星 上 之 后 ， 使 用 鼠标 滚 轴 可 以 调节 星星 的 大 小 半径 的 比例 。 

e 按 住 右键 拖 动 可 改变 星星 的 位 置 。 


J chaco_enable stars.py 
汐 Enable 库 的 组 件 制作 绘制 星星 的 界面 程序 


CE TE 


Le 


图 8-17 用 Enable 库 的 组 件 制作 的 绘制 星星 的 程序 界面 9 
Qo 
口 

由 于 程序 较 长 ， 我 们 只 详细 介绍 其 中 和 Component 类 相关 的 部 分 。 
交 
class Star(HasTraits): 至 
x = Float 
y = Float 表 

r = Float 


theta = Float 
n = Range(3，16) 
s = Float 
c= Tuple 
def polygon(self): 
return star_polygon(self.x, self.y, self.r, self.theta, self.n, self.s) 


首先 ,创建 一 个 Star 类 保存 和 星星 相关 的 所 有 属性 ,这 些 属性 就 是 前 面 介绍 的 star polygon0 
的 参数 。 通 过 Star 对 象 的 polygon() 方 法 可 以 得 到 表示 星星 形状 的 多 边 形 。 


class StarComponent(Component ) : 
stars = List(Star) 
star_color = Color((255,255,255)) 
edges = Range(3, 10, 5) 
sx = Float # 移动 开始 时 的 星星 中 心 X 坐标 
sy = Float # 移动 开始 时 的 星星 中 心 Y 坐标 
mx = Float # 移动 开始 时 的 鼠标 X 坐标 
my = Float # 移动 开始 时 的 鼠标 Y 坐标 


moving_star = Instance(Star) 
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event_state = Enum("normal", "drawing", "moving") 


StarComponent 类 是 实现 星星 绘制 及 响应 用 户 操作 的 组 件 类 ， 它 从 Component 继承 。 它 的 
各 个 Trait 属性 的 含义 如 表 8-4 所 示 。 


表 8-4_StarComponent 类 的 Trait 属性 


属 性 名 说 明 
stars 保存 所 有 星星 的 列表 
star color 当前 星星 的 颜色 
edges 当前 星星 的 项 角 数 
SX, Sy 开始 移动 时 的 星星 中 心 坐标 
mx, my 开始 移动 时 的 鼠标 坐标 
moving star 正在 移动 的 星星 对 象 
event state 当前 的 事件 状态 


Component 对 象 具有 绘图 以 及 响应 键盘 和 鼠标 事件 的 能 力 。 为 了 方便 编写 各 种 事件 处 理 方 
法 ，Component 的 父 类 Interactor 提供 了 一 种 名 为 “事件 状态 ”的 机 制 。 每 个 Component 对 象 
都 有 一 个 event_state 属性 ， 我 们 称 之 为 “事件 状态 ”。 当 界面 中 与 组 件 对 应 的 区 域 发 生 某 个 事 
件 时 ， 它 将 根据 当前 的 事件 状态 和 事件 名 ， 调 用 组 件 类 中 相应 的 事件 处 理 方法 。 例 如 ， 如 果 当 
前 的 事件 状态 是 "normal"， 而 事件 名 为 "left down"( 鼠 标 左 键 按 下 )， 那 么 如 果 在 组 件 类 中 定义 了 
名 为 “normal left down” 的 方法 ， 该 方法 将 被 调用 。 下 面 是 从 Enable 库 的 “interactorpy” 文 
件 中 找到 的 事件 名 ， 它 们 的 含义 可 以 很 容易 根据 名 称 猜测 出 来 ， 因 此 这 里 就 不 多 做 解释 了 : 


left down, left up, left dclick, 

right_down, right_ up, right dclick, 
middle_down, middle up, middle dclick, 
mouse_move, mouse wheel, 

mouse_enter, mouse_leave, 

key_pressed, 

dropped_on, drag_over, drag_enter, drag_leave 


下 面 列 出 StarComponent 类 中 定义 的 所 有 事件 处 理 方法 。 在 这 些 方法 中 , 会 修改 event_state 
属性 ， 实 现 不 同 状态 下 对 不 同事 件 的 响应 ， 事 件 状 态 的 漂移 如 图 8-18 所 示 。 


def normal_left_down(self，event) : 
"添加 一 个 Star 对 象 到 stars 列表 中 ， 并 切换 到 drawing 状态 " 
self.stars.append( 
Star(x=event.x, y=event.y, r=0, theta=0, n=self.edges, 
s = 8.5, c=convert_color(self.star_color))) 
self.event_state = "drawing" 
self.request_redraw() 


def drawing mouse move(self, event): 
"修改 stars 中 最 后 一 个 Star 对 象 的 半径 和 起 始 角度 " 
star = self.stars[-1] 
star.r = np.sqrt((event.x-star.x)**2+(event.y-star.y)**2) 
star.theta = np.arctan2(event.y-star.y, event.x-star.x) 
self.request_redraw() 
def drawing left up(self, event): 
"完成 一 个 星 形 的 绘制 ， 回 到 normal 状态 " 
self.event_ state = "normal” 
def normal mouse wheel(self, event): 
"找到 包含 鼠标 坐标 的 星 形 ， 并 修改 其 半径 比例 " 
star = self.find_star(event.x, event.y) 
if star is not None: 
star.s += event.mouse wheel * 6.62 
if star.s < 6.65: star.s = 6.65 
self.request_redraw() 
def normal right_ down(self, event): 
"找到 包含 鼠标 坐标 的 星 形 ， 用 moving_star 属性 保存 它 ， 并 进入 moving 状态 " 
star = self.find_star(event.x, event.y) 
if star is not None: 
self.mx，self.my = event.x，event.y # 记录 鼠标 位 置 
self.sx，self.sy = star.x，star.y # 记录 星 形 的 中 心 位 置 
self.moving_star = star 
self.event_state = "moving" 


def moving mouse move(self, event): 
"修改 moving_star 的 x、y 坐标 ， 实 现 星 形 的 移动 " 
self.moving_star.x = self.sx + event.x - self.mx 
self.moving_star.y = self.sy + event.y - self.my 
self.request_redraw() 

def moving_right_up(self, event): 
"移动 操作 结束 ， 回 到 normal 状态 " 


self.event_state = "normal” 
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图 8-18 StarComponent 类 的 事件 状态 漂移 
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在 事件 处 理 方法 中 , 通过 修改 event_state 属性 的 值 , 实现 了 事件 状态 的 漂移 .StarComponent 
对 象 共有 三 种 事件 状态 : "normal"、"drawing" 和 "moving"。 在 “normal” 状 态 下 按 下 鼠标 左 键 
会 调用 normal left down0， 此 方法 会 修改 event state 属性 ， 进 入 “drawing” 状 态 。 而 按 下 鼠 
标 右键 则 会 调用 normal right down0， 并 进入 "moving" 状 态 。 

每 个 事件 处 理 方法 都 有 一 个 event 参数 ， 它 描述 和 事件 有 关 的 详细 信息 。 在 Enable 库 的 

“eventspy” 文 件 中 可 以 找到 这 些 事件 对 象 的 定义 。 例 如 MouseEvent 是 鼠标 事件 对 象 , 它 的 x、 

y 属性 是 事件 发 生 时 的 鼠标 坐标 ， 它 还 有 alt down、control down 等 属性 ， 表 示 辅 助 键 是 否 被 
按 下 。 

当 保 存 星 形 对 象 的 stars 列表 发 生变 化 ， 或 者 其 中 的 元 素 发 生变 化 时 ， 都 需要 调用 组 件 的 
request_redraw0 方 法 刷新 绘图 。 而 具体 的 绘图 工作 在 _draw_overlay0 中 进行 ， 此 方法 会 在 需要 
重新 绘图 时 自动 被 调用 。 由 方法 名 可 知 ， 它 是 在 "overlay" 绘 图 层 绘制 图 形 。 


def _draw_overlay(self, gc, view bounds=None, mode="normal"): 
gc.clear((8,6,8,1) ) # 填 充 为 全 黑 
gc.save_state() 
for star in self.stars: 
draw_star(gc, star.x, star.y, star.r, star.c, star.theta, star.n, star.s) 
gc.draw_path() 
gc.restore_state() 


为 了 找到 使 用 鼠标 选中 的 星 形 , 我 们 需要 一 个 判断 点 是 否 在 多 边 形 之 内 的 函数 。 幸 好 Kiva 
库 中 已 经 有 实现 此 功能 的 函数 points in_ polygon0， 它 的 第 一 个 参数 可 以 是 一 个 点 ， 也 可 以 是 
一 系列 的 点 ;第 二 个 参数 是 一 个 表示 多 边 形 的 顶点 数组 ， 它 返回 元 素 值 为 0 或 1 的 数组 ，1 表 
示 对 应 的 点 在 多 边 形 内 部 。 使 用 此 函数 ， 我 们 很 容易 编写 出 找到 包含 坐标 点 (x,y) 的 星星 的 
find_star0 方 法 : 


def find_star(self, x, y): 
from enthought.kiva.agg import points_in_polygon 
for star in self.stars[::-1]: 
if points_in_polygon((x, y), star.polygon()): 
return star 
return None 


最 后 看 一 下 表示 主 界面 的 StarDesign 类 。 在 其 视图 定义 中 , 我 们 直接 使 用 box 对 象 的 edges 
和 star_color 属性 在 界面 中 创建 编辑 器 : 


class StarDesign(HasTraits): 
box = Instance(StarComponent) 


View = View( 
HGroup(Item("object.box.edges"，label=u" 顶 角 数 ")， 
Item("object.box.star_color"，1label=u" 颜 色 "))， 


Item("box", editor=ComponentEditor(),show_label=False), 
resizable=True, 


width = 666， 
height = 466， 
title = u" 星 空 设计 ” 


) 


def _init_ (self, **traits): 
super(StarDesign, self)._init (**traits) 
self.box = StarComponent() 


8.4.3 设计 圆 形 选择 工具 


Chaco 没有 使 用 圆 形 进行 选择 的 工具 ， 作 为 二 次 开发 的 实例 ， 本 节 将 介绍 如 何 自 己 动手 编 
写 一 个 圆 形 选 择 工 具 。 仿 照 前 面 介 绍 的 选择 工具 ， 我 们 将 编写 两 个 类 一 一 CircleSelection 和 
CircleSelectionOverlay, 它们 分 别 实现 鼠标 事件 的 处 理 和 圆 形 的 绘制 .它们 通过 绘图 对 象 的 index 
属性 的 名 为 'circle_center 和 'circle radius' 的 元 数据 进行 数据 交互 。 效 果 如 图 8-19 所 示 。 


’ A# chaco_tools_circle.py 
写 一 自己 设计 圆 形 选 择 工具 
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图 8-19 圆 形 选择 工具 
下 面 详细 分 析 源 程序 。 首 先是 用 于 绘制 圆 形 的 CircleSelectionOverlay 类 : 


class CircleSelectionOverlay(AbstractOverlay): © 
metadata = Property(depends_on = 'component’) © 
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def get metadata(self): 
return self.component.index.metadata 
def overlay(self, component, gc, view bounds=None, mode="normal"): 
if self.metadata.has_key('circle center'): 
x, y = self.metadata['circle center'] © 
r= self.metadata['circle radius'] 
gc.save_state() 
gc.set_alpha(86.4) 
gc.set_fil1_color(color_table["1ightskyblue"]) 
gc.set_stroke_color(color_table["dodgerblue"]) 
gc.set_line_width(1) 
gc.set_line_dash(None) 
gc.arc(x, y, r, 6.60, 2*np.pi) © 
gc.draw_path() 
gc.restore_state() 


@CircleSelectionOverlay 对 象 将 放 到 绘图 对 象 的 overlays 列表 中 , 因此 它 从 AbstractOverlay 
继承 。AbstractOverlay 中 定义 了 一 个 overlay0 方 法 ， 我 们 只 需 覆盖 此 方法 ， 在 其 中 完成 圆 形 的 
绘制 即 可 。 

@ 为 了 使 程序 简洁 ， 定 义 了 一 个 名 为 metadata 的 Property 属性 ， 它 得 到 的 是 component 
属性 中 index 数据 对 象 的 元 数据 。component 属性 在 父 类 AbstractOverlay 中 定义 ， 它 是 创建 
CircleSelectionOverlay 对 象 时 所 传递 的 第 一 个 对 象 ， 通 常 就 是 拥有 此 CircleSelectionOverlay 对 
象 的 绘图 对 象 。 

目 读 取 名 为 'circle center 和 'circle radius' 的 元 数据 ， 它 们 分 别 表示 圆 形 的 中 心 和 半径 。 由 于 
这 两 个 元 数据 保存 的 是 屏幕 坐标 系 中 的 坐标 和 长 度 ， 因 此 不 需要 进行 任何 坐标 变换 ， 可 以 直接 
使 用 它们 绘制 圆 形 。 

@ 圆 形 路 径 通 过 gc 对 象 的 arc0 方 法 创建 ，arc0 实 际 创建 的 是 圆 弧 路 径 ， 这 里 将 圆 弧 的 起 
始 角 度 和 终止 角度 设置 为 0 和 2x， 这 样 就 绘制 出 一 个 完整 的 圆 形 。 

CircleSelectionOverlay 类 很 简单 ， 而 响应 用 户 操 作 的 工作 都 在 CircleSelection 类 中 完成 。 
CircleSelection 对 象 负责 根据 用 户 的 操作 更 新 'circle_center' 和 'circle_radius' 元 数据 : 


class CircleSelection(AbstractController): © 
metadata = Property(depends_on = 'component') 
event_state = Enum('normal', 'selecting', 'selected', ‘moving') @ 
selection update = Event © 
x = Float # 圆心 的 X 坐标 
y = Float # 圆心 的 Y 坐标 
r = Float # 半径 
mx = Float # 移动 开始 时 鼠标 的 X 坐标 
my = Float # 移动 开始 时 鼠标 的 Y 坐标 


Float # 移动 开始 时 
Float # 移动 开始 


Xe 
ye 


nl 


def get metadata(self): 
return self.component.index.metadata 


@CircleSelection 类 从 AbstractController 继承 , 在 AbstractController 中 定义 了 component 属性 ， 
在 创建 CircleSelection 对 象 时 ， 我 们 将 绘图 对 象 传递 给 它 。 

@event state 属性 是 一 个 Enum 类 型 ， 允 许 有 4 种 事件 状态 ， 分 别 是 : 

e mormal: 通常 状态 ， 此 时 没有 圆 形 选区 。 

e selecting': 正在 进行 选择 ， 此 时 将 根据 鼠标 的 位 置 设置 圆 形 选区 的 半径 。 

e selected': 完成 圆 形 选区 的 选择 操作 。 

e ‘moving': 正在 移动 圆 形 选区 。 

@selection_update 是 一 个 Event 属性 ， 用 来 通知 其 他 对 象 选区 发 生 了 变化 。 


def normal_left_down(self，event) : 
self.x, self.y = event.x, event.y 
self.metadata[ 'circle center'] = self.x, self.y 
self.metadata[ 'circle radius’] = 9 
self.event state = 'selecting’ 
def selecting mouse move(self, event): 
self.r = np.sqrt((self.x-event.x)**2 + (self.y-event.y)**2) 
self.metadata[ 'circle radius'] = self.r 
self._update selection() 
def selecting left up(self, event): 
self.event_state = 'selected’ 
def selected left down(self, event): 
r= np.sqrt((self.x-event.x)**2 + (self.y-event.y)**2) 
if r > self.r: 
del self.metadata['circle_center'] 
del self.metadata['circle_radius'] 
del self.metadata['selections'] 
self.selection_update = True 
self.event_state 
else: 


normal 


self.mx, self.my = event.x, event.y 
self.x@, self.y@ = self.x, self.y 
self.event_state = ‘moving’ 
def moving mouse_move(self, event): 

self.x = self.x@ + event.x - self.mx 

self.y = self.y8 + event.y - self.my 

self.metadata['circle center'] = self.x, self.y 

self._update_selection() 
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def moving left up(self, event): 
self.event_ state = 'selected’' 


接 下 来 是 各 种 事件 的 处 理 方法 ， 它 们 根据 当前 的 事件 状态 和 事件 名 称 对 元 数据 进行 更 新 ， 
由 各 种 事件 引起 的 事件 状态 漂移 如 图 8-20 所 示 。 每 个 事件 处 理 方法 所 实现 的 功能 都 很 简单 , 这 
里 就 不 再 多 做 解释 了 。 


处 理 mouse move 


normal selecting 
无 选择 状态 Ieft dew 了 修改 半径 
Tory cw, left up 

姓 理 mouse nove .2 
moving ~ 、 Solected 
BO 一 left down( 四 内 ) 和 机 


left up 
图 8-20 事件 状态 的 漂移 图 


def update selection(self): 
points = np.transpose(np.array((self.component.index.get_data()， 
self.component.value.get_data()))) @ 
Screen_points = self.component.map_screen(points) © 
tmp = screen_points - np.array([self.x，self.y]) 
tmp **= 2 
dist = np.sum(tmp, axis=1) 
self.metadata['selections'] = dist < self.r*self.r @ 
self.selection update = True 


当 圆 心 坐标 或 半径 发 生 改 变 时 , 将 调用 _update_selection0。 它 将 根据 当前 的 圆 形 选择 区 域 ， 
更 新 名 为 'selections' 的 元 数据 。@ 首 先 ， 获 得 绘图 对 象 component 的 数据 点 的 坐标 ，points 是 一 
个 形状 为 QY, 2) 的 数组 ， 其 中 N 为 绘图 对 象 中 数据 点 的 个 数 。@ 由 于 points 数组 所 表示 的 是 数 
据 坐 标 系 中 的 坐标 ， 因 此 需要 调用 绘图 对 象 的 map_screen0 将 其 转换 成 屏幕 坐标 系 中 的 坐标 。 
@ 最 后 选择 屏幕 坐标 距离 圆心 坐标 小 于 半径 的 那些 数据 点 。'selections' 元 数据 是 一 个 布尔 数组 ， 
它 表 示 对 应 的 数据 点 是 否 落 入 了 圆 形 选区 之 内 。 

为 了 对 圆 形 选择 工具 进行 测试 ,在 程序 的 最 后 编写 了 CircleSelectionDemo 类 。 在 其 初始 化 
方法 _init 0 〇 中 创建 圆 形 选 择 工具 的 程序 段 如 下 所 示 : 


scatter = plot.plot(("x", "y"), type="scatter", color="blue")[8] 
scatter.tools.append( CircleSelection(scatter) ) 
scatter.overlays.append( ScatterInspectorOverlay(scatter, ©@ 
selection_color="red", selection marker="circle", 
selection outline_color = "black", 


selection marker_size = 6) ) 
scatter.overlays.append( CircleSelectionOverlay(scatter) ) 


@ 使 用 ScatterInspectorOverlay 突出 显示 被 选择 的 数据 ， 默 认 使 用 名 为 'selections' 的 元 数据 
表示 选区 。 由 于 它 在 CircleSelectionOverlay 之 前 被 添加 到 overlays 列表 中 ， 因 此 半 透 明 的 圆 形 
将 覆盖 在 被 选择 的 数据 点 之 上 。 


8.4.4 制作 动画 演示 


使 用 Chaco 或 Enable 还 可 以 制作 简单 的 二 维 动画 演示 。 制 作 动画 的 基本 方法 就 是 使 用 一 
个 定时 器 以 一 定 的 时 间 间 隔 重复 调用 某 个 绘图 函数 。 由 于 在 Traits 和 TraitsUI 库 中 没有 定义 定 
时 器 类 ， 因 此 需要 从 pyface 库 载 入 Timer 类 : 


from enthought.pyface.timer.api import Timer 
下 面 是 演示 正弦 波 移动 的 动画 程序 。 


有 # chaco_simple line anim.py 
六 下 正弦 波 移动 的 动画 演示 


class AnimationHandler(Handler): © 
def init(self, info): 
super(AnimationHandler, self).init(info) 
info.object.timer = Timer(10, info.object.on timer) @ 


def closed(self, info, is_ok): 
super(AnimationHandler, self).closed(info, is_ok) 
info.object.timer.Stop() © 


class Animationplot(HasTraits): 

plot = Instance(Plot) 

data = Instance(ArrayPlotData) 

phase = Float(6) 

traits_view = View( 
Item( 'plot' ,editor=ComponentEditor(), show_label=False), 
width=566，height=566，resizable=True，title="Plot Animation", 
handler = AnimationHandler()) © 


def _init_ (self, **traits): 
super(Animationplot, self)._ init (**traits) 
data = ArrayPlotData(x=[6]，y=[6]) 
plot = Plot(data) 
plot.plot(("x", "y"), type="line", color="blue") 
plot.title = "sin(x)" 
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self.plot = plot 
self.data = data 


def on timer(self): @ 
x = np.linspace(self.phase, self.phase+np.pi*4, 160) 
y = np.sin(x) 
self.phase += 86.62 
self.data["x"] = x © 
self.data["y"] = y 


@ 由 于 需要 在 显示 界面 的 同时 启动 定时 器 ， 在 界面 关闭 之 后 关闭 定时 器 ， 因 此 定义 了 一 个 
控制 器 类 AnimationHandler。@ 它 的 init0 方 法 在 界面 显示 时 调用 ， 我 们 在 其 中 为 模型 对 象 创建 
定时 器 对 象 。 定 时 器 将 每 10 毫秒 调用 一 次 模型 对 象 的 on_timer0 方 法 。@ 在 界面 关闭 之 后 ， 控 
制 器 对 象 的 closed0 方 法 将 被 调用 ， 我 们 在 这 里 关闭 定时 器 。 如 果 直 接 在 模型 对 象 的 _init 0 
中 创建 定时 器 ， 那 么 在 界面 显示 之 前 就 已 经 开始 调用 on_timer0 方 法 ， 在 界面 关闭 之 后 ， 模 型 
对 象 销毁 之 前 ， 仍 然 会 调用 on _timer0。 如 果 模 型 对 象 的 创建 和 销毁 与 界面 的 显示 和 关闭 几乎 
同步 ， 就 可 以 在 模型 对 象 的 _init 0 中 开启 定时 器 。 

@ 在 模型 类 AnimationPlot 的 on_timer(0 方 法 中 ， 逐 渐 增 加 phase 属性 的 值 ， 并 根据 当前 的 
phase 属性 计算 正弦 波 数据 ， 这 样 就 能 够 产生 正弦 波 移动 的 效果 。@ 我 们 只 需要 使 用 新 的 数据 
更 新 数据 源 即 可 ， 当 数据 源 中 的 数据 改变 时 ，Plot 对 象 将 自动 刷新 。 

使 用 同样 的 方法 , 我 们 也 可 以 直接 使 用 Component 类 制作 动画 演示 程序 。 下 面 的 程序 是 一 
个 很 酷 的 三 维 点 阵 变形 动画 演示 。 它 在 将 随机 产生 的 三 维 曲面 上 的 点 进行 三 维 旋转 和 投影 之 
后 ， 在 Compoent 组 件 上 使 用 Kiva 的 绘图 函数 快速 绘制 出 来 。 此 程序 留 给 读者 自行 研究 ， 这 里 
就 不 再 进行 详细 解释 了 。 图 8-21 是 此 程序 绘制 的 一 些 三 维 点 阵 图 形 。 


sh enable_ morph3d anim.py 
三 维 点 阵 变 形 动画 


图 8-21 三 维 点 阵 变形 动画 中 的 一 些 图 形 截图 


TVTK 一 一 数据 的 三 维 可 视 化 


VTIK 是 一 套 功能 十 分 强大 的 三 维 的 数据 可 视 化 库 ， 它 使 用 C+ 编写 而 成 ， 其 中 包含 了 近 
千 个 类 。 它 在 Python 下 有 标准 的 扩展 库 , 不 过 由 于 其 Python 扩展 库 的 API 和 C++ 的 API 相同 ， 
无 法 体现 出 Python 作为 动态 语言 的 优势 。 因 此 ，Enthought 公司 开发 了 一 套 名 为 TVTK 的 扩展 
库 来 对 VTK 进行 封装 ， 它 提供 了 Python 风格 的 API， 并 支持 Trait 属性 和 NumPy 数组 。 本 章 
将 以 TVTK 的 API 为 例 介绍 如 何在 Python 中 使 用 VTK 实现 数据 的 三 维 可 视 化 。 

由 于 TVTK 库 十 分 庞大 ， 为 了 方便 用 户 查 询 文 档 ，TVTK 库 提供 了 一 个 显示 TVTK 文档 

的 工具 。 读 者 可 以 通过 下 面 的 语句 运行 它 : 

>>> from enthought.tvtk.tools import tvtk_doc 

>>> tvtk_doc.main() 


TVTK 库 提供 的 工具 并 不 太 好 用 , 因此 本 书 为 读者 提供 了 一 个 更 方便 的 TVTK 文档 查询 工 
具 ， 其 界面 如 图 9-1 所 示 。 


办 tvtk_class_doc.py 
半 TVTK 文档 查询 工具 


Pe 


总 
总 
站 
的 
时 
二 
时 
-0 
1 
加 
nm 
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图 9-1 TVTK 文档 查询 工具 


第 一 次 运行 此 文档 工具 时 , 它 将 对 TVTK 库 中 所 有 的 类 进行 扫描 , 并 将 类 的 继承 关系 
和 文档 全 部 保存 在 “tvtk_classes.cache” 中 ， 这 个 过 程 可 能 需要 等 待 较 长 的 时 间 。 
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界面 的 左上 部 分 使 用 一 个 树 型 控件 来 显示 TVTK 中 各 个 类 之 间 的 继承 关系 ,在 中 间 的 文本 
框 中 输入 搜索 文本 ， 下 方 的 列表 框 中 会 实时 显示 搜索 结果 。 输 入 全 小 写字 母 ， 进 行 忽略 大 小 写 
的 搜索 ， 而 输入 带 大 写字 母 的 文本 则 会 进行 精确 搜索 。 


9.1 流水 线 (Pipeline) 


VTK 是 一 个 十 分 复杂 的 系统 ， 为 了 方便 用 户 使 用 ， 它 使 用 流水 线 技术 ， 将 VTK 中 的 各 个 
对 象 串联 起 来 。 每 个 对 象 只 需要 实现 相对 简单 的 任务 ， 整 个 流水 线 则 能 够 根据 用 户 的 需求 实现 
十 分 复杂 的 数据 可 视 化 处 理 。 


9.1.1 显示 圆锥 
作为 第 一 例子 ， 让 我 们 首先 看 一 个 显示 圆锥 的 小 程序 ， 它 的 运行 效果 如 图 9-2 所 示 。 


更 tvtk_simple_cone.py 
用 TVTK 快速 显示 圆锥 


from enthought.tvtk.api import tvtk © 


# 创建 一 个 圆锥 数据 源 ， 并 且 同 时 设置 其 高 度 、 底 面 半径 和 底面 圆 的 分 辩 率 (用 36 边 形 近 似 ) 
cs = tvtk.ConeSource(height=3.6，radius=1.6，resolution=36) @ 
# 使 用 PolyDataMapper 将 数据 转换 为 图 形 数据 

m= tvtk.PolyDataMapper(input = cs.output) © 

# 创建 一 个 Actor 

a = tvtk.Actor(mapper=m) @ 

# 创建 一 个 Renderer， 将 Actor 添加 进去 

ren = tvtk.Renderer(background=(1, 1, 1)) © 

ren.add_actor(a) 

# 创建 一 个 RenderWindow( 窗 口 )， 将 Renderer 添加 进去 

rw = tvtk.RenderWindow(size=(366,366)) © 

rw.add_renderer(ren) 

# 创建 一 个 RenderWindowInteractor( 窗 口 的 交互 工具 ) 

rwi = tvtk.RenderWindowInteractor(render_window=rw) © 

# 开启 交互 

rwi.initialize() 

rwi.start() 


图 9-2 使 用 TVTK 绘制 简单 的 圆锥 


@ 首 先 从 TVTK 库 中 载 入 tvtk 对 象 ， 它 可 以 帮助 我 们 创建 TVTK 库 中 的 各 种 对 象 。@ 创 
建 了 一 个 ConeSource 对 象 , 它 是 计算 圆锥 形状 的 数据 源 对 象 ,在 TVTK 中 , 所 有 类 都 从 HasTraits 
继承 ， 因 此 可 以 在 创建 对 象 的 同时 ， 使 用 关键 字 参 数 直 接 设 置 各 个 Trait 属性 的 值 。 在 这 个 例 
子 中 ， 同 时 设置 了 圆锥 的 高 度 、 底 面 半 径 和 底面 圆 的 边 数 "等 属性 。 


tvtk 对 象 是 什么 

事实 上 , 我 们 载 入 的 tvtk 并 不 是 一 个 模块 ， 而 是 某 个 类 的 实例 。 之 所 以 如 此 设计 ， 是 因 
为 VIK 库 有 近 干 个 类 ， 而 TVTK 对 这 些 类 进行 了 封装 ， 如 果 一 次 性 载 入 这 么 多 类 ,会 极 大 
地 影响 库 的 载 入 速度 。 

我 们 载 入 的 tvtk 虽然 是 某 个 实例 对 象 ， 但 是 用 起 来 却 和 模块 一 样 : 

。 通过 它 可 以 使 用 所 有 的 TVTK 类 。 

。 它 不 需要 载 入 近 生 个 TVTK 类 就 能 支持 类 名 的 自动 补 全 。 

e 只 有 在 真正 使 用 时 ，TVTK 类 才 会 载 入 。 

所 有 对 VTK 进行 封装 的 类 全 部 保存 在 “tvtk_classes.zip” 文 件 中 ， 而 tvtk 对 象 的 类 则 在 
此 压缩 文件 的 “tvtk_helperpy” 中 定义 。 对 于 VTK 中 的 每 个 类 ，tvtk 对 象 都 有 一 个 同名 的 属 
性 与 之 对 应 。 


可 以 使 用 print traits0 显 示 ConeSource 对 象 的 所 有 Trait 属性 ,为 了 节省 篇 幅 ， 这 里 只 挑选 
了 其 中 的 几 个 属性 : 


在 IPython 中 运行 此 程序 之 后 ， 将 无 法 关闭 显示 圆锥 的 窗口 ， 为 了 关闭 它 ， 请 直接 关 
闭 IPython 的 窗口 。 


@ 圆锥 的 底面 实际 上 是 一 个 正 多 边 形 。 
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>>> run tvtk_simple cone.py 
>>> cs.print traits() 


angle: 18.43494882292281 
center: array([ 6.， 8., 8.]) 
Class_name: "vtkConesource 
direction: BTayf[ Ls Os G1) 
height: 3.6 

radius: 1.9 

resolution: 36 

[[ 省 略 ]] 


为 了 将 原始 数据 转换 为 屏幕 上 的 一 幅 图 像 ， 需 要 经 过 许多 处 理 步 又。 这 些 步骤 由 众多 的 
VTK 对 象 分 步 实现 ， 就 好 像 生产 线 上 加 工 零件 一 样 , 每 位 工人 都 负责 一 部 分 工作 , 整 条 生产 线 
就 能 将 原材料 制作 成 产品 。 在 VIK 中 ， 这 种 在 各 个 对 象 之 间 协 调 完成 工作 的 过 程 被 称 为 流水 
线 (Pipeline)。 
原始 数据 被 加 工 成 图 像 要 经 过 两 条 流水 线 : 
。 可 视 化 流水 线 (Visualization Pipeline): 它 的 工作 是 将 原始 数据 加 工 成 图 形 数据 。 一 般 
来 说 ， 我 们 需要 进行 可 视 化 展示 的 数据 本 身 并 不 是 图 形 数据 ， 例 如 它 可 能 是 某 个 零 
件 内 部 各 个 部 分 的 温度 ， 或 者 是 流体 中 各 个 坐标 点 上 的 速度 等 。 

e 图 形 流水 线 (Graphics Pipeline): 它 的 工作 是 将 图 形 数 据 加 工 为 我 们 所 看 到 的 图 像 。 可 
视 化 流水 线 所 产生 的 图 形 数据 通常 是 三 维 空间 的 数据 ， 图 形 流水 线 将 这 些 三 维 数据 
加 工 成 能 在 二 维 屏幕 上 显示 的 图 像 。 

目 映 射 器 (MappenD) 是 可 视 化 流水 线 的 终点 、 图 形 流水 线 的 起 点 ， 它 的 各 种 派生 类 能 将 众多 
的 数据 映射 为 图 形 数据 以 供 图 形 流水 线 加 工 。 在 本 例 中 ，ConeSource 对 象 输出 一 个 描述 圆锥 的 
顶点 和 面 的 PolyData 对 象 ， 然 后 PolyData 对 象 通过 PolyDataMapper 映射 器 转换 为 图 形 数据 。 
因此 在 本 例 中 ， 可 视 化 流水 线 由 ConeSource 对 象 和 PolyDataMapper 对 象 组 成 。 

可 视 化 流水 线 中 的 对 象 经 由 input 和 output 属性 连接 起 来 。 例 如 ConeSource 对 象 的 output 
属性 是 一 个 PolyData 对 象 , 它 也 是 PolyDataMapper 对 象 的 input 属性 ,我 们 可 以 认为 ConeSource 
对 象 产 生 了 一 个 PolyData 对 象 ， 并 转交 给 PolyDataMapper 对 象 进行 处 理 : 


>>> cs.output 

<tvtk_classes.poly_data.PolyData object at 8x848EBD80> 
>>> m.input 

<tvtk_classes.poly_data.PolyData object at 6x648EBD86> 


然后 图 形 数据 再 依次 通过 Actor、Renderer 最 终 在 RenderWindow 中 显示 出 来 ， 这 一 部 分 
就 是 图 形 流水 线 。@Actor 对 象 代表 场景 中 的 一 个 实体 。 它 的 mapper 属性 是 表示 图 形 数据 的 
了 PolyDataMapper 对 象 ，Actor 对 象 还 有 许多 属性 可 以 控制 实体 的 位 置 、 方 向 、 大 小 等 : 


>>> a.mapper is m 


True 
>>> a.scale # Actor 对 象 的 scale 属性 表示 各 个 轴 的 缩放 比例 
array([ 1., 1., 1.]) 


@Renderer 对 象 表 示 三 维 场景 , 它 可 以 包括 多 个 Actor 对 象 ,这 些 Actor 对 象 都 保存 在 actors 
列表 属性 中 。 在 本 例 中 ， 它 只 包括 一 个 显示 圆锥 的 Actor 对 象 : 


>>> ren.actors 
['<tvtk_classes.actor.Actor object at 6x94D75726> '] 


@RenderWindow 对 象 表示 包含 场景 的 窗口 ， 它 可 以 同时 包含 多 个 场景 。 在 本 例 中 ， 它 只 有 
一 个 Renderer 对 象 : 


>>> rw.renderers 
['<tvtk_classes.renderer.Renderer object at 69x64F61669> '] 


@RenderWindowInteractor 对 象 为 图 形 窗口 提供 一 些 用 户 交互 功能 , 例如 平移 、 旋转 和 缩放 。 
这 些 交 互 式 操作 并 不 改变 场景 中 各 个 实体 (Actor 对 象 ) 或 图 形 数据 的 属性 , 它们 只 是 修改 场景 中 
照相 机 (Camera) 的 设置 ， 以 便 从 不 同 的 角度 和 距离 观察 场景 中 的 实体 。 


9.1.2 用 ivtk 观察 流水 线 


为 了 方便 对 流水 线 进行 观察 和 操作 ，TVTK 库 为 我 们 提供 了 一 个 很 方便 的 工具 一 一 ivtk。 
使 用 它 可 以 交互 式 地 对 各 种 TVTK 对 象 的 属性 进行 编辑 ， 下 面 是 使 用 ivtk 显示 圆锥 的 程序 , 运 
行 画面 如 图 9-3 所 示 。 


> A tvtk_ivtk_cone.py 
总 一带 流 水 线 浏览 器 和 Python 命令 行 的 ivtk 界面 


from enthought .tvtk.api import tvtk 


# 载 入 ivtk 所 需要 的 对 象 
from enthought .tvtk.tools import ivtk 
from enthought.pyface.api import GUI 


cs = tvtk.ConeSource(height=3.6，radius=1.6，resolution=36) 
m= tvtk.PolyDataMapper(input = cs.output) 
a = tvtk.Actor(mapper=m) © 


# 创建 一 个 GUI 对 象 ， 和 一 个 带 Crust(Python shel1) 的 ivtk 窗口 

gui = GUI() 

window = ivtk.IVTKWithCrustAndBrowser(size=(866,666)) © 
window.open() 

window. scene.add_actor( a ) 目 # 将 圆锥 的 actor 添加 到 窗口 的 场景 中 
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gui.start_event_loop() 


图 9-3 ” 带 流水 线 浏览 器 和 Python 命令 行 的 ivtk 界面 


@ 在 创建 了 表示 圆锥 的 Actor 对 象 之 后 ，@ 创 建 并 显示 了 一 个 ivtk 窗口 ，@ 调 用 窗口 对 象 
表示 场景 的 scene 属性 的 add_actor0 方 法 将 Actor 对 象 添加 到 场景 中 。 关 于 这 段 程序 的 详细 解释 
己 经 超出 了 本 书 的 范围 ， 请 感 兴趣 的 读者 自行 查看 各 个 函数 的 文档 和 源 代码 进行 分 析 。 下 面 让 
我 们 看 看 ivtk 窗口 的 各 个 组 成 部 分 : 

e 场景 : 用 于 显示 可 视 化 的 结果 ， 这 里 只 显示 了 一 个 圆锥 。 

e 场景 工具 条 : 位 于 场景 的 上 方 ， 主 要 提供 了 各 种 视角 、 全 屏 显示 、 保 存 图 像 等 功能 。 

。 流水 线 浏览 器 : 场景 的 左上 方 是 一 个 表示 流水 线 的 树 状 控 件 。 从 子 节点 (ConeSource) 

开始 逐步 向 上 层 直到 根 节点 (RendeD， 是 整个 显示 圆锥 的 流水 线 。 

e Python 命令 行 : 界面 下 方 提供 了 一 个 Python 命令 行 ， 在 其 中 可 以 访问 程序 中 的 全 局 

变量 ， 可 方便 用 户 直接 输入 命令 来 操作 各 个 对 象 。 例 如 图 中 显示 了 ConeSource 对 象 
所 输出 的 PolyData 对 象 的 points 属性 ， 即 构成 圆锥 图 形 的 各 个 项 点 的 三 维 坐标 。 

流水 线 浏览 器 中 显示 的 各 个 对 象 的 类 都 从 HasTraits 继承 ， 因 此 它们 可 以 提供 一 个 用 户 界 
面 ， 交 互 式 地 修改 其 Trait 属性 。 图 9-4 是 双击 流水 线 中 的 ConeSource 对 象 之 后 弹出 的 属性 编 
辑 界面 。 通 过 此 界面 可 以 直接 修改 height、radius、resolution 等 属性 ， 并 且 修 改 之 后 场景 中 的 
圆锥 会 根据 最 新 的 属性 值 立 即 更 新 显示 。 


个 双击 ConeSource 之 后 弹出 的 窗口 可 能 很 小 ， 需 要 手动 调整 其 大 小 。 


图 9-4 用 于 编辑 ConeSource 对 象 属性 的 对 话 框 


1. 照相 机 


在 ivtk 窗口 左 侧 的 流水 线 浏览 器 中 可 以 找到 场景 中 的 照相 机 对 象 一 -OpenGLCamera, 双 
击 它 将 弹出 如 图 9-5 所 示 的 编辑 照相 机 对 象 属性 的 对 话 框 。 


公车 可 捧 川 要 沼 沁 一 JJAL ， 


图 9-5 用 于 编辑 照相 机 属性 的 对 话 框 | 

也 可 以 使 用 下 面 的 程序 从 窗口 对 象 window 获得 照相 机 对 象 ， 然 后 查看 或 修改 它 的 属性 : | 

| 

PS | 


>>> camera = window.scene.renderer.active_camera 
>>> camera.clipping_rage 

array([ 28.46912341, 51.21854284]) | 
>>> camera.view up = 8,1,0 | 
>>> camera.edit_traits() # 显示 编辑 照相 机 属性 的 对 话 框 | 
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下 面 列 出 照相 机 对 象 的 一 些 常用 属性 : 
e clipping plane: 它 有 两 个 元 素 ， 分 别 表示 照相 机 到 近 、 远 两 个 裁剪 平面 的 距离 。 在 这 
两 个 平面 之 外 的 对 象 将 不 会 显示 。 

e _ position: 照相 机 在 三 维 空间 中 的 坐标 。 

e focal point: 照相 机 所 聚焦 的 焦点 坐标 。 

e view_up: 照相 机 的 上 方向 矢量 。 

e parallel projection: True 表示 采用 平行 透视 ， 即 在 三 维 场景 中 平行 的 直线 在 屏幕 上 也 

是 平行 的 。 

这 些 属性 虽然 可 以 完全 控制 照相 机 的 位 置 和 方向 , 但 是 实际 操作 起 来 并 不 方便 。 如果 已 经 
将 照相 机 的 焦点 固定 在 某 个 位 置 ， 可 以 调用 照相 机 对 象 的 下 面 两 个 方法 ， 在 以 焦点 为 原点 的 球 
面 坐标 系 中 对 照相 机 进行 操作 。 它 们 保持 照相 机 的 view_up 属性 不 变 。 

e azimuth(angle): 沿 着 纬度 线 旋转 指定 角度 ， 即 水 平 旋转 ， 改 变 其 经 度 。 

e _ elevation(angle): 沿 着 经 度 线 方 向 旋转 指定 角度 ， 即 垂直 旋转 ， 改 变 其 纬度 。 


2. 光源 


在 ivtk 窗口 中 ， 单 击 场景 上 方 工具 栏 中 最 后 一 个 齿轮 形状 的 图 标 ， 将 打开 如 图 9-6 所 示 的 
编辑 场景 和 光源 的 对 话 框 。 在 此 对 话 框 中 可 以 添加 和 删除 光源 ， 还 可 以 修改 它们 的 一 些 属性 。 


9-6 设置 场景 和 光源 的 对 话 框 


场景 中 的 光源 可 以 通过 Renderer 对 象 的 lights 属性 获得 ， 它 是 一 个 光源 对 象 的 列表 。 
Renderer 对 象 还 有 add_light0 和 remove light(O) 等 方法 ， 用 来 添加 或 删除 光源 对 象 。 


>>> lights = window.scene.renderer.lights 
>>> lights[8].edit_traits() # 显示 编辑 光源 属性 的 对 话 框 


下 面 的 程序 在 照相 机 所 在 位 置 添 加 一 个 红色 的 光源 ， 它 的 照射 方向 和 照相 机 的 方向 相同 ， 


朝向 focal point 点 。 如 果 设 置 光源 对 象 的 positional 属性 为 True， 它 将 变 成 一 个 探照灯 光源 ， 
这 时 照射 方向 有 效 ; 并 且 可 以 通过 cone_ angle 属性 设置 探照灯 的 光 锥 角度 ,如 果 光 锥 为 180”， 
它 就 是 无 方向 光源 。 


>>> camera = window.scene.renderer.active camera 
>>> light = tvtk.Light(color=(1,6,6)) 

>>> light.position=camera.position 

>>> light.focal point=camera.focal point 

>>> window.scene.renderer.add light(light) 


3. 实体 


Actor 对 象 表示 场景 中 的 实体 ， 在 圆锥 的 流水 线 浏览 器 中 ， 我 们 可 以 看 到 一 个 表示 圆锥 的 
Actor 对 象 。 双 击 它 可 以 打开 如 图 9-7 所 示 的 对 话 框 。 也 可 以 使 用 下 面 的 代码 打开 此 对 话 框 : 


>>> a.edit_traits() # a 是 表示 圆锥 的 Actor 对 象 


>>> window.scene.renderer.actors[6].edit_traits() 


在 了 Python 打开 的 属性 编辑 对 话 框 中 进行 修改 之 后 ， 需 要 激活 一 下 场景 窗口 才能 让 它 
进行 重 绘 。 


9-7 Actor 对 象 的 属性 编辑 对 话 框 


在 此 对 话 框 中 可 以 编辑 Actor 对 象 的 origin、position、orientation 和 scale 属性 ， 还 可 以 修 
改 场景 中 实体 的 位 置 、 方 向 及 大 小 。 这 4 个 属性 通过 一 系列 复杂 的 计算 可 得 到 一 个 4 x 4 的 三 
维 空间 的 变换 矩阵 。 其 变换 步 又 如 下 : 

e 以 origin 为 中 心 ， 使 用 scale 对 物体 在 三 个 轴 上 进行 缩放 。 

e 以 origin 为 中 心 , 使 用 rotate 对 物体 在 三 个 轴 上 进行 旋转 , 旋转 的 顺序 是 Y 轴 一 X 轴 

一 Z 轴 。 
e 将 物体 放 到 position 处 。 
我 们 通过 下 面 的 例子 理解 坐标 变换 的 步骤 。 首先 运行 如 下 程序 , 在 场景 中 添加 一 个 坐标 轴 : 
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>>> run tvtk_ivtk_cone.py 
>>> axe = tvtk.AxesActor(total_length=(3,3,3)) # 在 场景 中 添加 坐标 轴 
>>> window.scene.add_actor( axe ) 


可 以 看 到 屏幕 的 横 轴 方向 是 X 轴 ， 纵 轴 方 向 是 立轴 ， 从 屏幕 里 往外 是 Z 轴 方 向 。 整个 圆 
锥 的 长 度 为 3， 它 的 底面 在 X= -1.5 的 平面 之 上 。 双击 流水 线 对 话 框 中 表示 圆锥 的 Actor, 打开 
如 图 9-7 所 示 的 对 话 框 。 

将 origin 修改 为 (-1.5, 0, 0), 这 样 将 以 圆锥 的 底面 圆心 为 中 心 进行 缩放 和 旋转 。 依次 按照 图 
9-8 的 顺序 修改 各 个 属性 的 值 。 对 话 框 中 的 “F0”、“F1” 和 “F2” 等 标签 分 别 表示 X 轴 、Y 
轴 和 ZZ 轴 的 分 量 。 


Scale x =0.5 onentabon Y = -90 
] 4 
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图 9-8 依次 修改 圆锥 的 scale、orientation 和 position 属性 


请 读者 仔细 观察 每 两 幅 图 之 间 的 变化 ， 分 析 并 理解 前 面 的 坐标 变换 步 又。 旋转 的 正方 向 按 
照 右手 法 则 来 决定 ， 右手 握拳 ， 并 伸 出 大 拇指 让 它 指向 某 个 轴 的 正方 向 ， 其 余 四 指 的 方向 为 绕 
此 轴 旋 转 的 正方 向 。 

Actor 对 象 的 property 属性 是 一 个 OpenGLProperty 对 象 ， 它 包含 了 对 实体 进行 着 色 时 所 使 
用 的 各 种 配置 ， 例 如 color 属性 是 实体 的 颜色 、opacity 属性 是 实体 的 不 透明 度 。 输 入 下 面 的 语 
句 可 以 打开 编辑 这 些 属性 的 对 话 框 : 


>>> a.property.edit_traits() # a 是 表示 圆锥 的 Actor 对 象 


由 于 OpenGLProperty 对 象 的 属性 太 多 ， 这 里 不 一 一 进行 介绍 。 在 后 面 的 实例 中 用 到 时 再 
对 其 进行 说 明 。 


9.2 ”数据 集 (Dataseb 


数据 可 视 化 的 第 一 步 是 用 合适 的 数据 结构 表示 数据 ，VTK 提供 了 多 种 表示 不 同 种 类 数据 
的 数据 集 (DataseDb。 数 据 集 包括 点 (PoinD 和 数据 (Data) 两 个 部 分 。 点 之 间 可 以 是 连接 的 或 非 连接 
的 ， 多 个 相关 的 点 组 成 单元 (Cel)， 而 点 之 间 的 连接 可 以 是 显 式 或 隐 式 的 。 数 据 可 以 是 标量 或 矢 
量 ， 数 据 可 以 属于 点 或 单元 。 下 面 让 我 们 通过 一 些 实例 逐步 理解 数据 集 的 构造 。 

为 了 帮助 读者 更 形象 地 了 解数 据 集 的 结构 ， 我 们 使 用 Mayavi 将 数据 集 的 结构 绘制 成 三 维 
图 。 请 读者 在 学 习 的 过 程 中 运行 这 些 程序 ， 以 加 深 对 数据 集 的 理解 。 在 学 习 第 10 章 时 ， 也 可 以 
将 这 些 程序 作为 实例 ， 来 了 解 Mayavi 的 一 些 高 级 用 法 。 


sf erp 


六 和 使 用 Mayavi 绘制 数据 集 的 结构 


9.2.1 ImageData 


最 容易 理解 的 数据 集 是 ImageData， 它 是 表示 二 维 或 三 维 图 像 的 数据 结构 。 我 们 可 以 简单 
地 将 其 理解 为 二 维 或 三 维 数组 。 数 组 中 存放 的 是 数据 ， 由 于 点 位 于 正 交 、 等 间距 的 网 格 之 上 ， 
因此 不 需要 给 出 点 的 坐标 ， 而 点 之 间 的 连接 关系 也 由 它们 在 数组 中 的 位 置 决定 ， 因 此 连接 也 是 
隐 式 的 。 


tvtk_imagedata.py 
于 
总 二 ImageData 对 象 的 演示 程序 


下 面 的 代码 创建 了 一 个 ImageData 对 象 , 并 且 设置 了 它 的 spacing、 origin 和 dimensions 属性 : 
>>> img = tvtk.ImageData(spacing=(0.1,0.1,0.1), origin=(0.1,0.2,0.3), dimensions=(3,4,5)) 


origin 属性 为 三 维 网 格 数据 的 起 点 坐标 , spacing 属性 为 三 维 网 格 在 义 轴 、Y 轴 和 Z 轴 上 的 
间距 ，dimensions 属性 为 X 轴 、Y 轴 和 Z 轴 上 的 网 格 数 。img.get_point(n) 可 以 获得 网 格 中 第 n 
个 点 的 坐标 值 ，n 为 点 的 序号 ， 起 始点 的 序号 为 0， 序 号 依次 沿 着 义 轴 、Y 轴 和 Z 轴 递 增 。 下 
面 的 程序 输出 前 6 个 点 的 坐标 : 


>>> for n in range(6) : 
print "%.1f, %.1f, %.1f" % img.get_point(n) 
0.1, 8.2, 0.3 
0.2, 0.2, 0.3 
0.3, 8.2, 0.3 
0.1, 8.3, 0.3 
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0.2, 0.3, 0.3 
0.3, 0.3, 0.3 


与 每 个 点 对 应 的 数据 都 保存 在 point_data 属性 中 ， 它 是 一 个 PointData 对 象 : 


>>> img.point_data 
<tvtk_classes.point data.PointData object at 8x86622276> 


PointData 对 象 可 以 保存 多 组 数据 ， 它 的 scalars 属性 是 VTK 库 中 的 一 个 数组 对 象 ， 用 来 保 
存 与 每 个 点 对 应 的 标量 值 。 当 将 一 个 NumPy 数组 赋值 给 它 时 ，TVTK 将 自动 创建 VTK 中 相应 
的 数组 对 象 ， 并 保存 NumPy 数组 的 内 容 。 例 如 下 面 的 程序 运行 之 后 ，scalars 属性 从 None 变 成 
了 一 个 DoubleArray 数组 。 程 序 为 每 个 点 添加 了 一 个 与 其 序号 相同 的 标量 值 : 


>>> import numpy as np 

>>> img.point_data.scalars # 没有 数据 

None 

>>> img.point_data.scalars = np.arange(6.96，img.number_of_points) 
>>> img.point_data.scalars 

[8.0, ..., 59.0], length = 60 

>>> type(img.point data.scalars) 

<class 'tvtk_classes.double array.DoubleArray'> 


DoubleArray 数组 只 能 以 整数 为 下 标 ， 不 支持 切片 以 及 其 他 高 级 下 标 运算 。 可 以 通过 它 的 
to_array0 方 法 获得 与 其 共享 数据 存储 空间 的 NumPy 数组 , 通过 此 NumPy 数组 可 以 进行 更 高 级 
的 数据 存 取 操作 : 


>>> a = img.point_data.scalars.to_array() 
>>> a 

TY 人 TOUR 3 

>>> a[:2] = 19，11 

>>> img.point_data.scalars[6] 

16.9 

>>> img.point_data.scalars[1] 

11.6 


VTK 的 数组 对 象 有 许多 属性 ， 可 以 用 print_traits0 方 法 查看 各 个 属性 的 值 ， 例 如 number_ 
of tuples 属性 表示 数组 的 长 度 : 


>>> img.point_data.scalars.number_of_ tuples 
60 


每 个 VTK 数组 都 有 一 个 name 属性 保存 其 名 称 ， 下 面 的 语句 将 数组 的 名 称 设置 为 'scalars': 


>>> img.point_data.scalars.name = 'scalars’ 


了 PointData 对 象 可 以 保存 多 个 数组 , 它 所 包含 的 数组 的 个 数 可 以 通过 number of arrays 属性 
获得 ， 可 以 通过 add_array0 方 法 添加 新 的 数组 对 象 ,通过 remove_array0 方 法 删除 数组 对 象 , 通 
过 get_array0 和 get_array_name() 方 法 分 别 获得 数组 对 象 及 其 名 称 。 下 面 我 们 演示 这 些 方法 的 用 
法 。 首 先 创建 一 个 TVTK 的 数组 对 象 ， 并 调用 其 fom array0 方 法 ,通过 NumpPy 数组 设置 其 内 
容 ， 数 组 的 长 度 为 ImageData 对 象 的 点 数 : 


>>> data = tvtk.DoubleArray() # 创建 一 个 空 的 DoubleArray 数组 
>>> data.from array(np.zeros(img.number_of points)) 


接 下 来 将 TVTK 数组 对 象 的 名 称 设置 为 "zerodata": 


>>> data.name = "zerodata" 


然后 调用 PointData 对 象 的 add_array0 方 法 ， 将 创建 的 数组 添加 到 PointData 对 象 中 。 当 
PointData 对 象 已 经 有 相同 名 称 的 数组 时 ， 将 会 覆盖 原来 的 数组 。add_array0 方 法 的 返回 值 是 新 
数组 的 序号 ， 可 以 通过 此 序号 获得 数组 或 数组 名 : 


>>> img.point_data.add_array(data) 

>>> img.point_data.get_array(1) # 获得 第 1 个 数组 

[8.0, ..., 0.0], length = 69 

>>> img.point_data.get_array_name(1) # 获得 第 1 个 数组 的 名 称 
"zerodata" 

>>> img.point_data.get_array(8) # 获得 第 8 个 数组 

[10.0, ..., 59.0], length = 69 

>>> img.point_data.get_array_name(6) # 获得 第 6 个 数组 的 名 称 
"scalars” 


最 后 ， 使 用 remove_array0 方 法 通过 数组 名 删除 数组 : 


>>> img.point_data.remove_array("zerodata") # 删除 名 为 "zerodata" 的 数组 
>>> img.point_data.number_of_arrays 
1 


可 以 用 上 述 方法 对 PointData 对 象 中 的 多 个 数组 进行 管理 , 同时 为 了 方便 使 用 , 它 的 scalars 
属性 也 可 用 于 保存 数组 。 与 每 个 点 对 应 的 值 除 了 可 以 是 标量 之 外 ,还 可 以 是 矢量 或 张 量 (矩阵 )， 
矢量 数组 可 以 使 用 vectors 属性 保存 ， 而 张 量 数组 可 以 使 用 tensors 属性 保存 。 下 面 的 程序 将 一 
个 形状 为 Q3) 的 NumPy 数组 赋值 给 vectors 属性 ， 其 中 N 为 点 数 ， 这 样 InageData 对 象 中 的 每 
个 点 都 对 应 一 个 三 维 空间 中 的 矢量 : 


>>> vectors = np.arange(0.0, img.number_of points*3).reshape(-1, 3) 
>>> img.point_data.vectors = vectors 
>>> img.point_data.vectors 
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[(8.0, 1.0, 2.0), ..., (177.0, 178.0, 179.0)], length = 66 
>>> type(img.point_data.vectors) 

<class 'tvtk_classes.double array.DoubleArray'> 

>>> img.point_data.vectors[6] 

(6.6，1.6，2.6) 


我 们 看 到 : 创建 的 仍然 是 一 个 DoubleArray 对 象 ， 但 它 是 二 维 数 组 。number of tuples 属 
性 获得 其 第 0 轴 的 长 度 ， 而 number_of components 属性 获得 其 第 1 轴 的 长 度 : 


>>> img.point_data.vectors .number_of_tuples 

66 

>>> img.point_data.vectors.number_of_components 
3 


同样 ， 直 接 使 用 DoubleArray 对 象 的 方法 或 属性 对 其 进行 操作 比较 繁琐 ， 因 此 建议 读者 仍 
然 使 用 to_array0 方 法 在 将 其 转换 为 NumPpy 数组 之 后 再 进行 操作 。 

在 ImageData 对 象 中 ， 点 的 坐标 是 通过 spacing、origin 和 dimensions 等 属性 隐 式 定义 的 。 
与 之 类 似 , 点 和 单元 (Cel) 之 间 的 关系 也 是 隐 式 定义 的 。 单 元 和 点 之 间 的 关系 如 图 9-9 所 示 ( 见 
文 前 彩 插 )。 单 元 是 由 8 个 邻近 的 点 构成 的 立方 体 ,图 中 使 用 半 透 明 灰 色 立 方 体 标识 出 第 0 个 
单元 。 


病 (pojnt) 


a 


图 9.9 单元 (CelD) 和 点 (Poin0) 之 间 的 关系 


通过 get_cell0 方 法 可 以 获得 表示 单元 的 Voxel( 体 素 ) 对 象 ， 它 的 number of points、 
number_of edges 和 number_of faces 等 属性 分 别 是 构成 Voxel 对 象 的 点 数 、 边 数 及 面 数 : 


>>> cell = img.get_cel1(6) 

>>> cell 

<tvtk_classes.voxel.Voxel object at 6x65E65E46> 
>>> cell.number_of points 

8 


>>> cell.number_of edges 
Ep 

>>> cell.number of faces 
6 


point ids 属性 可 以 获得 构成 Voxel 对 象 的 点 的 序号 列表 ， 而 points 属性 则 获得 构成 Voxel 
对 象 的 点 的 坐标 : 


>>> cell.point ids 

[Oy 1 37 4, 32, 13 15> 16] 

>>> cell.points 
[(8.16666666666866681，8.28666686886668868881，8.29999999999999999)，...] 


ImageData 对 象 的 number of cells 属性 是 数据 集中 的 单元 数 ， 也 就 是 图 9-9 中 小 立方 体 的 
数 目 时 


>>> img.number_of cells 
24 


数据 集 提 供 了 许多 获取 点 和 单元 之 间 关 系 的 方法 。 例 如 ，get_point cells0 获 得 包含 某 个 点 
的 所 有 单元 的 序号 ， 而 get_cell pointsO 则 获得 某 个 单元 包含 的 所 有 点 的 序号 。 由 于 这 两 个 方法 
将 结果 写 入 一 个 IdList 对 象 中 ， 因 此 我 们 需要 先 创建 一 个 空 的 IdList 对 象 以 保存 结果 : 


>>> a = tvtk.IdList() 

>>> img.get_point_cells(3, a) 

>>> a # 序号 为 2 和 9 的 单元 包含 序号 为 3 的 点 
[2, @] 

>>> img.get_cell points(98, a) 

>>> a # 和 cell.point_ids 的 值 相 同 

[ol Dg 1 5 


IdList 是 VTK 中 管理 序号 的 列表 对 象 , 它 和 Python 的 标准 列表 一 样 支持 appendO 和 extendO 
方法 ， 并 且 可 以 通过 from array0 将 列表 或 数组 转换 为 ItList 对 象 : 


>>> a = tvtk.IdList() 
>>> a.from array([1,2,3]) 
>>> a.append(4) 

>>> a.extend([5,6]) 

>>> a 

be de 


与 每 个 单元 对 应 的 数据 都 保存 在 cell_data 属性 中 ， 它 是 一 个 CellData 对 象 ， 其 用 法 和 
PointData 对 象 类 似 ， 这 里 就 不 再 多 做 介绍 了 。 
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>>> img.cell data 
<tvtk_classes.cell data.CellData object at 6x6139C636> 


9.2.2 RectilinearGrid 


ImageData 是 最 简单 的 数据 集 ， 它 的 所 有 点 都 在 一 个 等 间距 的 三 维 网 格 之 上 ， 因 此 只 需要 
起 始 坐标 、 网 格 大 小 以 及 网 格 间距 等 信息 就 可 以 计算 出 网 格 上 所 有 点 的 坐标 。 如 果 要 表示 间距 
不 均匀 的 网 格 , 那么 可 以 使 用 RectilinearGrid 数据 集 。 下面 的 程序 创建 如 图 9-10 所 示 的 网 格 ( 见 
文 前 彩 插 ): 


办 Tvtk rectilineargrid py 


吉 


全 RectilinearGrid 对 象 的 演示 程序 


Bet_cell(1) 


图 9-10 使 用 RectilinearGrid 创建 分 布 不 均匀 的 网 格 


x = np.array([6,3,9,15]) 

y = np.array([8,1,5]) 

z = np.array([6,2,3]) 

r= tvtk.RectilinearGrid() 
r.x_coordinates =x © 

r.y_coordinates =y 

r.z_coordinates = Z 

r.dimensions = len(x), len(y), len(z) @ 


r.point_data.scalars = np.arange(0.0,r.number_of points) 
r.point_data.scalars.name = 'scalars" 


RectilinearGrid 和 ImageData 相同 ， 所 有 点 都 在 一 个 正 交 的 网 格 之 上 ， 所 不 同 的 是 网 格 的 
分 布 是 不 均匀 的 。 因 此 需要 通过 一 些 属性 设置 X 轴 、Y 轴 和 ZZ 轴 的 各 个 网 格 平面 的 位 置 。@ 通 
过 RectilinearGrid 对 象 的 x_coordinates、y_coordinates、z_coordinates 属性 ， 可 以 分 别 设置 网 格 
中 与 X 轴 、Y 轴 和 ZZ 轴 垂 直 的 平面 的 位 置 。RectilinearGrid 对 象 中 的 点 就 是 所 有 这 些 平面 的 交 
点 。@ 由 于 RectilinearGrid 对 象 不 会 根据 这 三 个 数组 的 长 度 自动 调整 dimensions 属性 ， 因 此 需 
要 根据 数组 的 长 度 对 dimensions 属性 进行 设置 。 旨 最 后 通过 point_data 属性 设置 每 个 点 对 应 的 
数据 。 


和 ImageData 对 象 一 样 ， 点 的 序号 依次 沿 着 XX 轴 、YY 轴 和 ZZ 轴 递 增 ， 例 如 : 


>>> run tvtk rectilineargrid.py 
>>> for i in xrange(6): 
print r.get point(i) 

(0.0, 08.0, 90.6) 

(3.0, 68.0, 9.0) 

(9.0, 60.0, 9.0) 

(15.0, 0.0, 8.0) 
(6.96，1.6，6.6) 

(3.9，1.6，6.6) 


单元 和 点 之 间 的 关系 也 和 ImageData 一 样 : 


>>> Cc = r.get cell(1) 

>>> c.point_ ids 

{5 re 7 os | 

>>> c.points 

[(3.6, 0.0, 80.0), (9.0, 86.0, 80.6), (3.0, 1.0, 9.0), (9.0, 1.0, 0.0), 
(3.0, 8.0, 2.0), (9.0, 9.0, 2.0), (3.0, 1.0, 2.0), (9.0, 1.0, 2.6)] 


9.2.3 StructuredGrid 


比 RectilinearGrid 更 进一步 ，StructuredGrid 需要 我 们 指定 每 个 点 的 坐标 。 而 点 和 单元 之 间 
的 关系 仍然 由 点 在 网 格 中 的 位 置 决定 。 图 9-11 显示 了 两 种 用 StructuredGrid 创建 的 网 格 结构 ( 见 
文 前 彩 插 )。 


训 因 下 王 茜 序 


9-11 用 StructuredGrid 创建 的 网 格 结构 
下 面 对 创 建 这 两 个 网 格 的 程序 进行 分 析 。 


a tvtk_structuredgrid.py 
言 _# 用 StructuredGrid 创建 的 网 格 结构 
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def make_points_array(x，y，z): 
return np.c_[x.ravel(), y.ravel(), z.ravel()] 
z, y, Xx = np.mgrid[:3.0, :5.6, :4.0] © 
x*= (4-z)/3 ©@ 
y*= (4-z)/3@ 
s1 = tvtk.StructuredGrid() 
s1.points = make_ points array(x, y, z) © 
s1.dimensions = x.shape[::-1] @ 
s1.point_data.scalars = np.arange(8，s1.number_of_points) 
s1.point data.scalars.name = 'scalars" 


@ 首 先 用 Numpy 的 mgrid 对 象 创建 了 三 个 数组 一 一 x、y 和 z。 它 们 的 形状 都 是 (3,5,4)。 其 
中 ,数组 x 的 数据 在 第 2 轴 上 变化 ， 数 组 y 的 数据 在 第 1 轴 上 变化 ， 数 组 z 的 数据 在 第 0 轴 上 
变化 。 在 这 三 个 数组 中 ， 对 应 下 标的 数值 组 成 等 间距 网 格 上 的 点 。@ 将 每 个 点 的 义 轴 和 YY 轴 
的 坐标 值 , 乘 以 由 Z 轴 坐标 值 决定 的 系数 。 沿 着 Z 轴 正 方向 乘积 系数 逐渐 变 小 ， 相 当 于 将 垂直 
乙 轴 的 网 格 进行 不 同比 例 的 收缩 。 最 终 形成 一 个 如 图 9-11( 左 ) 所 示 的 梯形 网 格 。 

全 StructuredGrid 对 象 的 points 属性 是 数据 集中 每 个 点 的 坐标 。 它 是 一 个 表示 N 个 点 的 坐 
标的 数组 ， 形 状 为 ON, 3)。 因 此 需要 将 三 个 形状 为 (3,5,4) 的 多 维 数组 合并 成 一 个 形状 为 (3*5*4, 3) 
的 二 维 数组 。 这 个 转换 工作 由 make_points_array0 完 成 。 其 中 ， 首 先 调用 参数 数组 的 ravel0 方 
法 得 到 其 平坦 化 之 后 的 一 维 数组 ， 然 后 通过 np.c 对象 将 三 个 一 维 数组 按 列 组 合成 二 维 数组 。 

@ 将 StructuredGrid 对 象 的 dimensions 属性 设置 为 (4.5.3)。 在 points 属性 中 只 保存 点 的 坐标 ， 
点 之 间 的 关系 由 dimensions 属性 决定 。dimensions 和 Numpy 数组 的 shape 属性 类 似 , 但 是 其 中 
第 0 轴 的 变化 最 快 ， 因 此 需要 将 数组 的 shape 属性 倒序 之 后 再 赋值 给 它 。 经 过 dimensions 属性 
处 理 之 后 ， 各 个 点 之 间 的 关系 如 图 9-12 所 示 。 图 中 每 个 小 方块 代表 points 属性 中 的 一 个 点 , 方 
块 上 的 数字 表示 点 在 points 属性 中 的 下 标 。 


9-12 dimensions 为 (4.5.3) 的 StructuredGrid 的 点 的 结构 


单元 由 网 格 中 相 邻 的 几 个 点 构成 ， 因 此 单元 2 由 图 9-12 中 8 个 灰色 矩形 表示 的 点 构成 ; 


>>> run tvtk_structuredgrid.py 
>>> sl.get cell(2).point ids 
(ere eM | 


于 单元 的 形状 不 是 长 方 体 ， 因 此 VTK 采用 Hexahedron 对 象 表示 单元 ， 它 有 get_ face0 
和 get_edge0 方 法 分 别 获得 构成 此 单元 的 面 和 边 : 


>>> c = sl.get_cell(2) 

>>> type(c) 

<class “tvtk_classes.hexahedron.Hexahedron "> 
>>> c.number_of_faces # 单 元 的 面 数 

6 

>>> f = c.get_face(9) # 获 得 第 8 个 面 

>>> type(f) # 每 个 面 用 一 个 Quad 对 象 表示 
<class ‘tvtk_classes.quad.Quad’'> 

>>> f.point_ids # 构 成 第 8 面 的 4 个 点 的 下 标 
| 

>>> c.number_of_edges # 单元 的 边 数 

12 

>>> e = c.get_edge(6) # 获 得 第 9 个 边 

>>> type(e) 

<class "tvtk_classes.line.Line"> 

>>> e.point_ids # 够 成 第 9 边 的 两 个 点 的 下 标 
[2，3] 


使 用 StructuredGrid 可 以 创建 出 任意 形状 的 网 格 , 例如 下 面 的 程序 可 以 创建 图 9-11( 右 ) 所 示 
的 半 个 空心 圆柱 。 程 序 中， 首先 在 圆柱 坐标 系 中 创建 等 距 网 格 ， 然 后 将 各 点 坐标 转换 到 直角 坐 
标 系 中 ， 具 体 的 步骤 留 给 读者 自行 分 析 。 


r，theta，z2 = np.mgrid[2:3:3j, -np.pi/2:np.pi/2:6j, 8:4:7j] 
x2 = np.cos(theta)*r 

y2 = np.sin(theta)*r 

5s2 = tvtk.StructuredGrid(dimensions=x2.shape[::-1]) 
s2.points = make_points_array(x2, y2, z2) 
5s2.point_data.scalars = np.arange(0, s2.number_of _ points) 
Ss2.point_data.scalars.name = 'scalars’ 


9.2.4 PolyData 


PolyData 数据 集 由 一 系列 的 点 、 点 之 间 的 连 线 以 及 由 点 构成 的 多 边 形 面 组 成 。 这 些 信息 都 
需要 用 户 进行 设置 ， 因此 用 程序 创建 PolyData 对 象 比较 繁琐 。TVTK 中 的 许多 三 维 模型 类 都 输 
出 PolyData 对 象 。 例 如 在 9.1.1 节 中 介绍 的 创建 圆锥 数据 的 ConeSource 类 : 


>>> source = tvtk.ConeSource(resolution = 4) 
>>> source.update() # 让 source 计算 其 输出 数据 


>>> cone = source.output 
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>>> type(cone) 
<class "tvtk_classes.poly_data-PolyData > 


我 们 看 到 ConeSource 对 象 的 输出 数据 是 一 个 PolyData 对 象 。PolyData 对 象 的 points 属性 
是 一 个 保存 点 的 坐标 的 数组 。 为 了 方便 查看 各 个 点 的 坐标 ， 我 们 用 NumPy 的 array_str0 函 数 输 
出 此 数组 的 内 容 ， 利 用 suppress_small 参数 将 很 小 的 数 显示 为 0: 


>>> print np.array_str(cone.points.to_array(), suppress_small=True) 
[[85 6. 8. 1] 
[-8.5 6.5 86. ] 
[-8.5 -6. 9.5] 
[-8.5 -6.5 -6. ] 
[-8.5 86. -0.5]] 


由 于 我 们 设置 了 ConeSource 对 象 的 resolution 属性 为 4， 因 此 圆锥 的 底面 是 一 个 正方 形 。 
由 各 个 点 的 坐标 很 容易 看 出 底面 垂直 于 义 轴 ， 并 且 在 X= -0.5 的 平面 上 ， 而 圆锥 的 顶点 在 和 轴 
上 的 X=0.5 处 。 各 个 点 之 间 的 联系 由 polys 属性 决定 : 


>>> type(cone.polys) 

<class "tvtk_classes.cell_array.CellArray '> 

>>> cone.poly.number_of_cells # 圆锥 有 5 个 面 

上 

>>> cone.polys.to_array() 

Dron( la dd 3 2 32 OA 2 3 9390 SA 3 a 


polys 属性 是 一 个 CellArray 对 象 ， 其 中 保存 各 个 面 和 点 之 间 的 关系 。 我 们 创建 的 圆锥 有 5 
个 面 ， 因 此 CellAray 对 象 的 number of cells 属性 为 5。CellArray 对 象 内 部 使 用 一 个 一 维 整数 
数组 保存 构成 各 个 面 的 点 的 下 标 。 由 于 构成 每 个 面 的 点 数 可 能 不 同 ， 因 此 它 还 需要 保存 构成 每 
个 面 的 点 数 。 我 们 可 以 把 这 个 一 维 数组 理解 为 如 下 所 示 的 构造 : 其 中 每 一 行 对 应 一 个 面 ， 冒 号 
前 面 的 数值 是 构成 此 面 的 点 数 ， 冒 号 后 面 的 一 串 数字 是 每 个 点 在 points 属性 中 的 下 标 。 由 下 面 
的 数据 可 知 ， 方 锥 由 4 个 三 角形 和 1 个 四 边 形 构成 : 


ww ww 上 
SoSOOoOP 
PHUDPL 
PPAPWUDNDD 


下 面 我 们 看 看 如 何 直接 创建 PolyData 对 象 。 首 先是 一 个 简单 的 方 锥 的 例子 : 


o tvtk_polydata py 
富生 用 PolyData 创建 多 面体 


p1 = tvtk.PolyData() 
p1.points = [(1,1,0),(1,-1,8),(-1,-1,0),(-1,1,08),(9,0,2)] © 
faces = [ 
4,0,1,2,3, 
3,4,8,1, 
3,4,1,2, 
3,4,2,3, 
3,4,3,0 
] 
cells = tvtk.CellArray() @ 
cells.set_cells(5, faces) © 
p1.polys = cells 
p1.point_data.scalars = np.linspace(8.6，1.9，len(p1.points)) 


@ 在 介绍 StucturedGrid 时 ， 我 们 将 一 个 形状 为 (N,3) 的 数组 赋值 给 points 属性 ， 这 里 使 用 
坐标 列表 进行 赋值 ， 其 效果 和 使 用 数组 相同 。@ 为 了 给 polys 属性 赋值 ， 需 要 首先 创建 一 个 新 
的 CellArray 对 象 。@ 然 后 调用 CellArray 对 象 的 set_cells0 设 置 其 内 容 ， 第 一 个 参数 为 面 (单元 ) 
的 个 数 ， 第 二 个 参数 是 描述 各 个 面 的 构成 的 数组 (或 列表 )。 所 创建 的 方 锥 如 图 9-13( 左 ) 所 示 ， 
图 中 标 出 了 各 个 点 的 序号 ( 见 文 前 彩 插 )。 PolyData 对 象 中 的 各 个 面 可 以 通过 get_cell0 方 法 获得 ， 
图 中 标 出 了 第 0 个 面 和 第 1 个 面 。 


>>> run tvtk_polydata.py 

>>> pl.get cell(8).point ids 
LDR 2 3] 

>>> pl.get_cel1(1).point_ids 
[4，9,，1] 


9-13 用 PolyData 创建 的 多 面体 


下 面 是 使 用 PolyData 创建 半球 面 的 程序 ， 图 9-13( 右 ) 是 半球 面 的 显示 效果 ( 见 文 前 彩 插 )。 
为 了 显示 出 整个 半球 上 的 点 ， 图 中 将 面 隐藏 ， 仅 显示 各 个 面 的 边框 : 


N= 16 
a, b = np.mgrid[@:np.pi:N*1j, @:np.pi:N*1j] 
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x = np.sin(a)*np.cos(b) 

y = np.sin(a)*np.sin(b) 

z= np.cos(a) 

from tvtk_structuredgrid import make points array 
points = make_points_array(x, y, z) © 
faces = np.zeros(((N-1)**2, 4), np.int) © 
t1, t2 = np.mgrid[:(N-1)*N:N, :N-1] 
faces[:,8] = (tl+t2).ravel() 

faces[:,1] = faces[:,86] + 1 

faces[:,2] = faces[:,1] + N 

faces[:,3] = faces[:,8] + N 


p2 = tvtk.PolyData(points = points，polys = faces) 
p2.point_data.scalars = np.linspace(89.6，1.9，len(p2.points)) 


首先 将 球 坐 标 系 中 的 点 转换 为 直角 坐标 系 中 的 坐标 。@ 然 后 调用 前 面 介绍 的 make_ 
points_array0， 将 这 些 坐 标 值 转换 为 形状 为 ON, 3) 的 数组 。@ 如 果 每 个 面 的 点 数 相同 ， 就 可 以 用 
一 个 二 维 数组 表示 面 和 点 之 间 的 关系 ， 其 中 第 0 轴 的 长 度 为 面 数 ， 第 1 轴 的 长 度 为 每 个 面 的 点 
数 。 可 以 将 此 二 维 数组 直接 赋值 给 polys 属性 ，TVTK 库 会 帮 我 们 完成 二 维 数组 到 CellArray 对 
象 的 转换 : 


>>> p2.polys.to_array() 
1 


请 读者 根据 程序 思考 faces 数组 的 计算 方法 ， 这 里 就 不 再 多 做 解释 了 。 
9.3 “可视化 实例 


由 于 篇 幅 受 限 ， 本 书 不 可 能 对 VTK 库 的 用 法 进行 详细 的 解释 。 在 本 节 中 ， 我 们 将 对 几 个 
比较 典型 的 实例 进行 分 析 。 和 希望 读者 在 学 习 这 几 个 实例 之 后 能 够 融会 贯通 ， 掌 握 VTK 开发 的 
一 般 流程 以 及 使 用 TVTK 为 开发 带 来 的 便利 。 

从 VTK 的 网 站 可 以 下 载 大 量 的 C+ 和 TCL 的 程序 实例 , 由 于 TVTK 的 用 法 更 加 简洁 , 读 
者 应 该 能 很 容易 将 它们 转换 成 使 用 TVTK 库 的 Python 程序 。 

本 节 的 程序 需要 使 用 VTK 提供 的 演示 数据 ， 如 果 读 者 安装 了 Python(x,y)， 那 么 这 些 演示 
数据 可 以 在 “Ci:\Python26WVTKData” 中 找到 。 此 路 径 已 经 在 环境 变量 VIK_ DATA_ROOT 中 
定义 ， 读 者 可 以 输入 下 面 的 语句 验证 一 下 : 

>>> import os 


>>> os.environ["VTK_DATA_ROOT"] 
'C:\\Python26\\VTKData’ 


如 果 读 者 的 计算 机 上 没有 演示 数据 和 环境 变量 ， 请 将 本 书 附带 光盘 中 的 VTKData 文件 夹 
复制 到 本 章 的 源 程序 文件 夹 中 。 

在 本 节 的 可 视 化 实例 程序 中 ， 将 使 用 下 面 的 辅助 模块 utility。 其 中 的 vtk_data0 获 得 VTK 
数据 文件 的 路 径 ， 而 show_actors0 则 使 用 ivtk 显示 一 组 Actor 对 象 。 


有 


可 视 化 实例 的 辅助 函数 


import os 

import os.path as path 

from enthought.tvtk.tools import ivtk 
from enthought.pyface.api import GUI 


def vtk_data(name) : 
folder = os.environ.get("VTK_DATA ROOT", "VTKData") 
datapath = os.path.join(folder, "data", name) 
if not path.exists(datapath): 
raise IOError("please set environment variable: VTK_DATA_ROOT") 
return datapath 


def show actors(actors, shell=False): 
gui = GUI() 
if shell: 
window = ivtk.IVTKWithCrustAndBrowser(size=(866,666)) 
else: 
window = ivtk.IVTKWithBrowser(size=(666,466)) 
window.open() 
for a in actors: 
window.scene.add actor( a ) 
window.scene.background = (1,1,1) 
return window, gui 


9.3.1 切面 


展示 三 维 数据 的 一 个 比较 简单 的 方法 是 使 用 切面 ， 将 切面 经 过 的 数据 进行 可 视 化 ， 这 样 就 
把 一 个 三 维 数据 的 可 视 化 问题 转换 成 了 二 维 数据 的 可 视 化 。 通 过 交互 式 地 修改 切面 的 位 置 和 方 
向 ， 用 户 能 直观 地 对 三 维 数据 进行 观察 。 下 面 是 使 用 切片 工具 观察 数据 的 一 个 实例 ， 效 果 如 图 
9-14 所 示 。 它 由 三 部 分 组 成 : 一 个 曲面 、 一 个 平面 和 一 个 外 框 。 在 曲面 和 平面 上 ， 每 个 点 通过 
颜色 表示 其 对 应 的 数值 的 大 小 。 由 于 我 们 使 用 ivtk 显示 可 视 化 结果 ， 因 此 可 以 使 用 界面 左 侧 的 
流水 线 浏览 器 观察 组 成 整个 场景 的 流水 线 。 


a tvtk_cut_plane.py 
使 用 切面 观察 三 维 数据 
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9-14 ”使 用 切面 观察 SucturedGrid 数据 集 


import numpy as np 
from enthought.tvtk.api import tvtk 
from utility import vtk_data, show actors 


def read_data(): 
# 读 入 数据 
plot3d = tvtk.PLOT3DReader( © 
xyz_file name = vtk_data("combxyz.bin"), 
q_file name = vtk_data("combq.bin"), 
scalar_function number = 1060, vector function number = 266 
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) 
plot3d.update() © 
return plot3d 


if _name _ == ”main 
plot3d = read_data() 


# 创建 颜色 映射 表 

lut = tvtk.LookupTable() © 

import pylab as pl 

lut.table = pl.cm.cool(np.arange(8,256))*255 @ 


# 显示 StructuredGrid 中 的 一 个 网 格 面 
plane = tvtk.StructuredGridGeometryFilter( © 
input = plot3d.output, extent = (8, 160, 89, 160, 6, 6) 
) 
plane_mapper = tvtk.PolyDataMapper(lookup_table = lut, input = plane.output) @ 
plane_mapper.scalar_range = plot3d.output.scalar range @ 
plane_actor = tvtk.Actor(mapper = plane_mapper) © 
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下 面 先 看 看 曲面 的 制作 过 程 。@ 为 了 对 可 视 化 方法 进行 重点 介绍 ， 我 们 直接 使 用 一 个 
PLOT3DReader 对 象 从 数据 文件 读 入 三 维 数据 信息 。@ 为 了 让 PLOT3DReader 对 象 真正 从 文件 
读 入 数据 ， 需 要 调用 它 的 update0 方 法 。 运 行 此 方法 之 后 ， 就 可 以 查看 output 属性 所 表示 的 数 
据 集 了 。 


>>> run tvtk_ cut plane.py 
>>> type(plot3d.output) 
<class 'tvtk classes.structured grid.StructuredGrid'> 


PLOT3DReader 读 入 PLOT3D 格式 的 文件 , PLOT3D 是 一 个 用 于 对 流体 力学 数据 进行 可 视 
化 的 程序 。 程 序 中 通过 设置 scalar_function number 和 vector_function number 属性 ， 分 别 指定 
标量 数组 和 矢量 数组 为 流体 的 密度 和 速度 。 各 个 参数 的 具体 含义 请 读者 查看 VTK 的 相关 文档 。 
PLOT3DReader 对 象 输出 的 是 一 个 StructuredGrid 数据 集 。 下 面 观 察 它 的 一 些 属性 : 


>>> s = plot3d.output 
>>> s.dimensions 
array([57, 33, 25]) 
>>> s.points 
[(2.6676666553131164，-3.7747686678582764，23.832926674462891)，...， 
(16.516666228881836，5.6621468462524414，35.749378264345763)] ，length = 47625 
>>> s.cell data.number_of_arrays 
8 
>>> s.point_data.number_of_arrays 
4 
>>> for i in xrange(4): 
print s.point data.get_array_name(i) 
Density 
Momentum 
StagnationEnergy 
Velocity 
>>> s.point_data.scalars.name 
Density 
>>> s.point_data.vectors.name 
Velocity 


由 上 面 的 各 个 属性 可 以 得 知 ，plot3d 对 象 输出 的 数据 集 是 一 个 形状 为 (57, 33, 25) 的 网 格 。 
由 于 它 是 一 个 StmcturedGrid 对 象 ， 因 此 网 格 中 每 个 点 的 坐标 保存 在 points 属性 中 。 网 格 中 的 
单元 没有 数据 ， 而 每 个 点 对 应 4 种 数据 ， 它 们 的 名 字 分 别 为 “Density”、“Momentum”、 
“StagnationEnergy” 和 “Velocity”。 其 中 , 通过 point_data 的 scalars 属性 可 以 获得 名 为 “Density” 
的 数组 ， 它 是 一 个 标量 数组 ， 而 “Velocity” 数 组 则 可 以 通过 point_data 的 vectors 属性 获得 ， 
它 是 一 个 三 维 矢量 数组 。 切 面 将 针对 scalars 属性 的 数据 进行 运算 ， 因 此 切面 所 显示 的 是 切面 上 
每 个 点 的 密度 值 。 
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四 我 们 需要 把 切面 上 的 密度 用 某 种 颜色 来 表示 ， 因 此 需要 进行 值 到 颜色 的 转换 。 在 VTK 
中 ， 这 种 转换 工作 由 LookupTable 对 象 完成 。@LookupTable 对 象 的 table 属性 是 一 个 保存 颜色 
表 的 数组 。 这 里 使 用 matplotlib 库 的 颜色 映射 对 象 来 计算 LookupTable 对 象 的 颜色 。 

LookupTable 对 象 的 range 属性 保存 值 的 范围 ， 它 将 这 个 范围 之 内 的 值 映 射 到 table 属性 的 
颜色 表 之 上 。 在 本 例 中 ，LookupTable 对 象 的 取 值 范围 和 密度 数组 的 范围 一 致 ， 而 密度 数组 的 
范围 可 以 通过 StructuredGrid 对 象 的 scalar range 属性 快速 获得 : 


>>> lut.range 

array([ 6.19781369， 6.71641924]) 

>>> s.point_data.scalars.range 
(8.19781369366226196，68.71641923761367798) 
>>> s.scalar_range 

(8.19781389366226196, 8.71841923761367798) 


@StructuredGridGeometryFilter 对 象 能 从 StructuredGrid 对 象 中 提取 部 分 网 格 。 程 序 中 通过 
extent 属性 指定 了 提取 的 网 格 的 范围 : 第 0 轴 和 第 1 轴 的 范围 是 0 到 100， 而 第 2 轴 的 范围 是 6 
到 6。 其 中 , 第 0、1 轴 的 范围 大 于 网 格 在 这 两 个 方向 上 的 长 度 ， 因 此 它们 提取 这 两 个 轴 上 的 整 
个 范围 ,而 在 第 2 轴 上 只 提取 第 6 层 的 数据 .StmucturedGridGeometryFilter 对 象 输出 一 个 PolyData 
数据 集 : 


>>> p = plane.output 


>>> type(p) 
<class "tvtk_classes.poly_data.PolyData "> 


下 面 查看 这 个 PolyData 对 象 的 一 些 属性 : 


>>> p.number_of_points 

1881 

>>> s.dimensions[6]*s.dimensions[1] 
1881 


它 由 1881 个 点 构成 ， 因 为 它 是 StructuredGrid 对 象 中 第 2 轴 上 的 一 层 ， 所 以 它 的 点 数 等 于 
原始 数据 集 的 第 0 轴 长 度 和 第 1 轴 长 度 的 乘积 。 下 面 比较 StructuredGrid 对 象 和 PolyData 对 象 
中 点 的 坐标 : 


>>> s.dimensions 

array([57, 33, 25]) 

>>> tmp1 = s.points.to_array().reshape((25,33,57,3)) 
>>> tmp2 = p.points.to_array().reshape((33,57,3)) 
>>> np.all(tmp1[6] == tmp2) 

True 


tmpl 是 将 StmcturedGrid 对 象 的 点 还 原 成 三 维 网 格 之 后 的 数组 ， 数 组 的 第 3 轴 表示 每 个 点 
的 义 轴 、Y 轴 和 Z 轴 的 坐标 值 ,由 于 NumpPy 数组 的 shape 属 性 和 StructuredGrid 对 象 的 dimensions 
属性 之 间 是 倒序 关系 ， 因 此 dimensions 属性 的 第 0 轴 相 当 于 shape 属性 的 第 2 轴 。 同 样 ， 我 们 
将 PolyData 对 象 的 点 还 原 成 一 个 表示 二 维 网 格 的 数组 tmp2。 由 于 我 们 提取 的 是 StructuredGrid 
对 象 中 第 2 轴 的 第 6 层 数据 ， 因 此 tmp1[6] 应 该 和 tmp2 相等 。 

使 用 StructuredGridGeometryFilter 对 象 不 但 从 数据 源 提取 了 点 的 坐标 ， 而 且 还 提取 了 每 个 
点 所 对 应 的 数据 ， 因 此 PolyData 对 象 的 每 个 点 也 对 应 有 4 组 数据 ， 并 且 数 组 名 保持 不 变 : 


>>> p.point_data.number_of_arrays 
4 

>>> p.point_data.scalars.name 
"Density” 


@ 使 用 PolyDataMapper 对 象 将 PolyData 对 象 转换 为 图 形 数据 ， 同 时 用 前 面 创 建 的 颜色 映 
射 表 Iut 对 PolyData 对 象 中 的 每 个 点 进行 着 色 。@ 为 了 能 使 用 颜色 映射 表 中 的 所 有 颜色 ， 我 们 
将 颜色 映射 表 的 范围 设置 成 和 密度 数组 的 范围 一 致 .@ 最 后 创建 在 场景 中 显示 图 形 数据 的 Actor 
对 象 。 

接 下 来 分 析 创 建 平 面 切面 的 程序 : 


# 做 一 个 平面 切面 

cut_plane = tvtk.Plane(origin = plot3d.output.center, normal=(-0.287, 6, 80.9579)) © 
cut = tvtk.Cutter(input = plot3d.output, cut function = cut plane) © 

cut_mapper = tvtk.PolyDataMapper(input = cut.output, lookup_ table = lut) 

cut_actor = tvtk.Actor(mapper = cut_mapper) 


@ 首 先 创 建 表示 平面 的 Plane 对 象 。 它 是 一 个 经 过 origin 属性 表示 的 坐标 点 ， 法 线 方向 为 


normal 属性 的 无 限 平面 , 通过 这 两 个 属性 可 以 唯一 确定 平面 。 Plane 对象 的 输出 是 一 个 PolyData 
对 象 ; 


>>> type(plane.output) 
<class “tvtk_classes.poly_data.PolyData'> 


四 创建 一 个 Cutter 对 象 ， 它 使 用 传递 给 cut_function 属性 的 Plane 对 象 ， 对 input 属性 的 
StructuredGrid 对 象 进行 切面 计算 。Cutter 对 象 的 输出 也 是 PolyData 对 象 ， 由 于 StructuredGrid 
对 象 中 的 点 不 一 定 能 正好 落 在 Plane 对 象 所 指定 的 平面 之 上 , 因此 Cutter 对象 会 对 StmucturedGrid 
对 象 中 的 数据 进行 插值 计算 。 它 所 输出 的 PolyData 对 象 中 的 点 不 再 是 数据 源 中 的 点 。 


>>> cut.output.number_of_points 
2537 


但 是 ，PolyData 对 象 中 的 每 个 点 仍然 与 4 组 数据 相对 应 ， 这 些 数据 都 是 通过 对 数据 源 的 数 
据 进行 插值 计算 得 到 的 : 
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>>> cut.output.point data.number_of_arrays 
4 


为 了 在 场景 中 显示 切面 ,就 像 前 面 的 曲面 一 样 , 可 以 使 用 PolyDataMapper 和 Actor 将 PolyData 
对 象 加 工 成 场景 中 的 物体 。 
接 下 来 创建 StucturedGrid 对 象 的 外 边框 部 分 : 


# StructuredGrid 网 格 的 外 边框 

outline = tvtk.StructuredGridOutlineFilter(input = plot3d.output) 
outline_mapper = tvtk.PolyDataMapper(input = outline.output) 
outline actor = tvtk.Actor(mapper = outline_mapper) 

outline actor.property.color = 0.3, 80.3, 0.3 


可 以 使 用 StucturedGridOutlineFilter 对 象 计算 出 一 个 表示 外 边框 的 PolyData 对 象 。 请 读者 
根据 前 面 介绍 的 方法 观察 此 PolyData 对 象 的 内 容 ， 这 里 就 不 再 举例 了 。 
最 后 使 用 utility 模块 中 定义 的 show_actors0 显 示 前 面 创建 的 3 个 Actor 对 象 一 plane_actor、 


cut_actor 和 outline_actor: 


win, gui = show_actors([plane_actor, cut_actor, outline_actor]) 
Bui. start_event_loop() 


在 界面 左 侧 的 流水 线 浏览 器 中 ,双击 某 个 对 象 可 以 打开 它 对 应 的 编辑 器 对 对 象 的 各 种 属 
性 进行 编辑 。 例 如 ， 可 以 打开 Plane 对 象 的 编辑 器 。 在 此 编辑 器 中 修改 Plane 对 象 的 original 和 
normal 属性 ， 从 而 改变 切面 的 位 置 和 方向 ， 观 察 数据 集中 不 同位 置 的 密度 分 布 情况 。 打 开 
StructuredGridGeometryFilter 对 象 的 编辑 器 ， 可 以 修改 曲面 切面 的 范围 。 图 9-15 显示 了 这 两 个 
编辑 器 ， 以 及 通过 它们 修改 之 后 的 切面 ( 见 文 前 彩 插 )。 


修改 提 职 的 范 画 


图 9-15 ”通过 编辑 器 修改 切面 的 位 置 和 方向 


9.3.2 ”等 值 面 
等 值 面 是 标量 场 中 标量 值 相 等 的 曲面 , 和 地 图 中 的 等 高 线 类 似 。 在 VTK 中 , 使 用 Contour- 


Filter 计算 等 值 面 。 下 面 的 程序 可 以 对 前 面 的 流体 数据 进行 等 值 面 可 视 化 ,效果 如 图 9-16 所 示 ( 见 
文 前 彩 插 )。 


a tvtk_contours.py 
使 用 等 值 面 对 标量 场 进 行 可 视 化 


图 9-16 使 用 等 值 面 对 标 量 场 进行 可 视 化 


plot3d = read data() 
contours = tvtk.ContourFilter(input = plot3d.output) 
contours.generate_values(8，plot3d.output.point_data.scalars.range) © 
mapper = tvtk.PolyDataMapper(input = contours.output， 

scalar_range = plot3d.output.point_data.scalars.range) @ 
actor = tvtk.Actor(mapper = mapper) 
actor.property.opacity = 9.3 © 


首先 使 用 前 面 介绍 的 read_data0 函 数 读 入 数据 。@ 创 建 一 个 ContourFilter 对 象 ， 并 且 调用 
其 generate_values0 方 法 创建 8 个 等 值 面 ， 等 值 面 的 取 值 范围 由 标量 值 数 组 scalars 的 范围 决定 。 
@ 等 值 面 的 颜色 映射 也 由 scalars 数组 的 范围 决定 。 由 于 没有 设置 映射 器 的 颜色 表 ， 因 而 将 使 用 
系统 默认 的 映射 表 ， 将 最 小 值 映 射 为 红色 ， 将 最 大 值 映射 为 蓝 色 。 

由 于 8 个 等 值 面 是 嵌 套 的 ， 我 们 需要 修改 等 值 面 的 Actor 对 象 的 透明 度 ， 以 便 观察 等 值 面 
的 内 部 构造 。 除 了 使 用 generate_values0 创 建 等 差 等 值 面 之 外 ， 还 可 以 使 用 set_value0 方 法 直接 
设置 每 个 等 值 面 的 值 ， 而 使 用 get_value0 方 法 则 可 以 获得 等 值 面 的 值 。 下 面 的 代码 在 IPython 
中 修改 第 0 个 等 值 面 的 值 : 


>>> run tvtk_contours.py 

>>> contours.get_value(6) 
8@.19781389366226196 

>>> contours.set value(6, 06.21) 


修改 之 后 ， 只 需要 旋转 或 移动 一 下 场景 就 能 看 到 所 作 的 修改 。 也 可 以 使 用 下 面 的 代码 强制 
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场景 重新 绘制 : 


>>> win.scene.render() 


在 这 个 例子 中 ， 同 一 个 等 值 面 上 所 有 点 的 颜色 是 相同 的 。 因 为 等 值 面 上 的 标量 值 (流体 密 
度 ) 相 同 ， 而 对 等 值 面 进行 着 色 时 ， 默 认 也 使 用 标量 值 。 但 有 时 候 ， 我 们 希望 等 值 面 的 颜色 由 另 
外 的 标量 值 决定 。 下 面 的 程序 演示 了 如 何 使 用 别 的 标量 值 对 等 值 面 进行 着 色 。 


g A tvtk_contours2.py 
写 天 使 用 别 的 标量 对 等 值 面 进行 着 色 


plot3d = read_data() 

plot3d.add function(153) © 

plot3d.update() 

contours = tvtk.ContourFilter(input = plot3d.output) 

contours.set_value(6，6.32) @ 

mapper = tvtk.PolyDataMapper(input = contours.output, 
scalar_range = plot3d.output.point data.get_array(4).range, © 
scalar_mode = "Use point field data") @ 

mapper.color_by_array_component("VelocityMagnitude"，6) © 

actor = tvtk.Actor(mapper = mapper) 

actor.property.opacity = 6.6 


@ 首 先 调 用 PLOT3DReader 对 象 的 add_function0 方 法 , 为 每 个 点 添加 一 组 标量 值 。 所 增加 
的 新 数组 名 为 VelocityMagnitude， 表 示 每 个 点 对 应 的 速度 大 小 ， 我 们 将 使 用 此 数组 对 等 值 面 进 
行 着 色 : 


>>> run tvtk_contours2.py 
>>> plot3d.output.point_data.get_array_name(4) 
"VelocityMagnitude 


四 调用 ContourFilter 对 象 的 set_value0 方 法 ， 创 建 一 个 值 为 0.32 的 等 值 面 。 目 设置 映射 器 
的 标量 范围 属性 scalar range， 将 它 设 置 为 新 增加 的 数组 的 取 值 范围 。@scalar_ mode 属性 决定 
映射 器 所 使 用 的 标量 数据 类 型 ， 这 里 "use_point field_data" 表 示 使 用 点 数据 中 的 数组 ， 它 有 如 下 
几 种 选择 : 

e "default": 使 用 point_data.scalars， 如 果 不 存 在 就 使 用 cell_data.scalars。 

®@ "use_point_data": 使 用 point_data.scalars。 

®@ "Use_cell data": 使 用 cell_data.scalars。 

e "use_ point field_data": 使 用 point_data 中 的 某 个 数组 ， 有 具体 的 数组 需要 另外 指定 。 

®@ "use _cell field data": 使 用 cell_data 中 的 某 个 数组 ， 有 具体 的 数组 需要 另外 指定 。 


全 通过 color by amay component0 指 定 着 色 所 使 用 的 数据 。 它 的 第 一 个 参数 是 数组 名 ， 第 
二 个 参数 是 从 数组 中 所 选择 的 列 。 由 于 "VelocityMagnitude" 是 一 个 标量 数组 ， 它 只 有 一 列 数据 ， 
因此 第 二 个 参数 为 0。 如果 第 一 个 参数 是 矢量 数组 名 ， 例 如 "Velocity"， 那 么 可 以 通过 第 二 个 参 
数 选择 矢量 数组 中 的 不 同 分 量 。 例 如 ，0 表示 选择 X 轴 方 向 的 速度 ，1 表示 选择 Y 轴 方 向 的 速 
度 , 2 表示 选择 Z 轴 方 向 的 速度 。 请 读者 修改 这 两 个 参数 , 使 用 其 他 的 数据 对 等 值 面 进行 着 色 。 


9.3.3 流 线 


在 前 面 的 实例 中 , 我们 使 用 切面 和 等 值 面 对 流 体 的 密度 分 布 进行 了 可 视 化 。 空 间 中 每 一 点 
的 密度 都 可 以 用 一 个 数值 (标量 ) 来 表示 ， 因 此 我 们 将 密度 分 布 理 解 为 一 个 标量 场 。 而 流体 在 每 
一 点 的 速度 是 一 个 矢量 ， 因 此 速度 的 分 布 情况 需要 使 用 矢量 场 来 描述 。 本 节 介绍 如 何 使 用 随机 
散布 的 矢量 箭头 和 流 线 对 矢量 场 进行 可 视 化， 效果 如 图 9-17 所 示 ( 见 文 前 彩 插 )。 由 此 图 可 知 ， 
整个 场景 由 4 个 实体 构成 : 外 框 、 随 机 散布 的 矢量 箭头 、 表 示 流 线 源 的 球体 以 及 流 线 。 


十 机 基 虽 着 头 一 全 一 一 


图 9-17 矢量 场 的 可 视 化 


> tvtk_streamline.py 
污 使 用 流 线 和 随机 散布 的 矢量 箭头 可 视 化 矢量 场 


# 读 入 数据 
plot3d = read_data() 


# 矢量 箭头 
mask = tvtk.MaskPoints(input = plot3d.output, random mode=True, on_ratio=50) © 
arrow_source = tvtk.ArrowSource() © 
arrows = tvtk.Glyph3D(input = mask.output, source=arrow_source.output, © 
scale_factor=2/np.max(plot3d.output.point_data.scalars.to_array())) 
arrows_mapper = tvtk.PolyDataMapper(input = arrows.output, 
scalar_range = plot3d.output.point data.scalars.range) 
arrows_actor = tvtk.Actor(mapper = arrows_mapper) 


上 面 的 代码 创建 随机 散布 的 矢量 箭头 。 这 些 箭头 的 起 始点 是 数据 集中 点 的 坐标 ， 箭 头 的 方 
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向 由 点 对 应 的 矢量 决定 ， 而 箭头 的 大 小 和 颜色 则 由 点 对 应 的 标量 决定 。 本 例 中 ， 箭 头 的 方向 表 
示 了 速度 的 方向 ， 而 大 小 和 颜色 则 表示 了 密度 。 箭 头 越 大 表示 该 点 的 标量 值 (密度 ) 越 大 ， 箭 头 
的 颜色 也 同时 表示 标量 值 的 大 小 ， 红 色 对 应 的 标量 值 最 小 ， 而 蓝 色 对 应 的 标量 值 最 大 。 

@ 由 于 原始 数据 集中 的 点 数 很 多 ， 如 果 在 所 有 点 的 位 置 都 描绘 箭头 ， 将 十 分 耗 时 并 且 无 法 
区 分 众多 的 箭头 。 因 此 首先 使 用 MaskPoints 对 象 对 数据 集中 的 数据 进行 随机 选取 ， 某 点 被 选中 
的 概率 为 150 ， 即 每 50 个 点 选择 一 个 点 。 下 面 的 代码 查看 MaskPoints 对 象 输出 的 数据 类 型 和 
点 数 ， 以 及 每 个 点 所 对 应 的 数据 : 


>>> run tvtk_streamline.py 

>>> plot3d.output.number_of_points 

47625 

>>> type(mask.output) 

<class "tvtk_classes.poly_data.PolyData '> 
>>> mask.output.number_of_points 

936 

>>> mask.output.point_data.number_of_arrays 
4 


@ArrowSource 对 象 创建 表 示 箭 头 的 PolyData 数据 集 。@Glyph3D 对 象 对 箭头 数据 进行 复 
制 ， 在 masks 输出 的 PolyData 数据 集 的 每 个 点 上 都 放置 一 个 箭头 。 箭 头 的 方向 、 长 度 和 颜色 由 
与 点 对 应 的 矢量 和 标量 数据 决定 。scale_factor 参数 是 所 有 箭头 的 共同 缩放 系数 ， 这 里 使 用 标量 
数组 的 最 大 值 对 缩放 系数 进行 正规 化 。Glyph3D 对 象 可 以 对 任意 的 PolyData 数据 进行 复制 , 读 
者 可 以 尝试 将 箭头 数据 源 ArowSource 改 为 圆锥 数据 源 ConeSource: 


>>> arrow_source.output.number_of_points # 一 个 箭头 有 31 个 点 

El 

>>> arrows.output.number_of_points # 箭头 被 复制 了 936 份 ， 因 此 有 938*31 个 点 
28836 


我 们 还 可 以 使 用 流 线 直观 地 观察 矢量 场 。 流 线 上 每 一 点 的 切线 方向 就 是 矢量 场 在 该 点 的 方 
向 。 下 面 是 显示 流 线 的 代码 : 


# 作为 流 线 起 点 的 球 

center = plot3d.output.center 

sphere = tvtk.SphereSsource( ©@ 
center=(2，center[1]，center[2])，radius=2， 
phi_resolution=6，theta_resolution=6) 

sphere_mapper = tvtk.PolyDataMapper(input = sphere.output) 

sphere_actor = tvtk.Actor(mapper = sphere_mapper) 

sphere_actor.property.set( 
representation =“wireframe"，color=(6,6,6)) 


# 流 线 

streamer = tvtk.StreamLine( ©@ 
input = plot3d.output, 
source = sphere.output, 
step_length = 6.6661， 
integration direction = "forward", 
integrator = tvtk.RungeKutta4()) © 


tube = tvtk.TubeFilter( @ 
input = streamer.output, 
radius = 9.65， 
number_of_sides = 6， 
vary_radius = "vary_radius by _scalar") 


tube_mapper = tvtk.PolyDataMapper( 

input = tube.output， 

scalar_range = plot3d.output.point_data.scalars.range) 
tube_actor = tvtk.Actor(mapper = tube_mapper) 
tube_actor.property.backface_culling = True 


SphereSource 对 象 创建 表示 球体 的 PolyData 数据 集 。 通 过 center 和 radius 属性 指定 球体 
的 球 心 位 置 和 半径 。phi_resolution 和 theta_resolution 属性 指定 球体 的 经 度 和 纬度 方向 上 的 等 分 
次 数 ， 分 割 得 越 细 ， 输 出 的 PolyData 数据 集 越 接近 球体 。 

@StreamLine 对 象 在 矢量 场 中 计算 流 线 。 计 算 流 线 的 起 点 坐标 由 其 source 属性 中 点 的 坐标 
决定 。 这 里 我 们 以 SphereSource 对 象 输出 的 球体 上 的 点 作为 流 线 的 计算 起 点 。 如 果 通 过 
start_position 属性 设置 起 始点 的 坐标 ， 将 只 计算 一 条 流 线 。step_length 属性 决定 了 流 线 上 点 的 
间隔 , 此 属性 值 越 小 , 流 线 上 的 点 越 多 , 流 线 越 平滑 , 计算 所 需 的 时 间 也 越 长 .integration_direction 
属性 决定 流 线 的 计算 方向 ， 值 可 以 为 backward'、'forward' 或 integrate_ both_directions'。'forward' 
表示 计算 起 点 之 后 的 流 线 ，'backward' 表 示 计 算 起 点 之 前 的 流 线 。@ 流 线 的 计算 需要 使 用 由 
integrator 属性 指定 的 数值 积分 算法 ， 这 里 使 用 RungeKutta4, 它 是 一 个 4 阶 Runge-Kutta 积分 
算法 。 

StreamLine 对 象 的 输出 是 一 个 PolyData 数据 集 , 它 的 所 有 单元 都 是 表示 流 线 的 路 径 , 因此 
边 (line) 数 为 23， 面 数 为 0: 


>>> streamer .output.number_of_points 
5529 

>>> streamer .output.number_of_polys 
[2 

>>> streamer .output.number_of_lines 
23 
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@ 使 用 TubeFilter 对 象 可 以 将 流 线 路 径 转换 为 有 粗细 的 圆 管 。radius 属性 为 圆 管 的 粗细 ， 
number of side 属性 指定 圆 管 的 切面 圆 的 边 数 。 圆 管 的 粗细 可 以 根据 点 的 数据 发 生变 化 ， 这 里 
使 用 "vary_ radius by_scalar" 指 定 圆 管 的 粗细 由 标量 (密度 ) 决 定 。 

TubeFilter 对 象 的 输出 也 是 PolyData 数据 集 , 它 由 众多 的 面 构成 ,但 是 它 的 number of polys 
属性 却 等 于 0: 


>>> tube.output.number_ of _ polys 
8 


这 里 为 了 节省 内 存 空间 和 计算 时 间 ，PolyData 对 象 使 用 TriangleStrip 对 象 表示 三 角 面 。 一 
个 TriangleStrip 对 象 由 一 组 点 构成 。 每 连续 的 三 个 点 都 将 构成 一 个 三 角 面 : 


>>> tube.output.number of_strips 

138 

>>> 七 = tube.output.get_cell(@) 

>>> type(t) 

<class “tvtk_classes.triangle_strip.TriangleSstrip'> 
>>> 上 t.number_of_points 

498 


在 上 面 的 例子 中 , 箭头 的 大 小 和 颜色 、 流 线 的 粗细 和 颜色 所 表示 的 是 流体 的 密度 。 有 时 候 ， 
我 们 希望 用 这 些 可 视 化 元 素 表示 矢量 的 长 度 ， 即 流体 的 速度 大 小 。 可 以 直接 计算 vectors 数组 
中 各 个 矢量 的 长 度 ， 并 且 将 结果 写 入 数据 集 的 scalars 数组 中 。 例 如 ,在读 入 数据 之 后 如 下 添加 
两 行 代码 : 


# 读 入 数据 

plot3d = read_data() 

拓 添加 下 面 两 行 代码 

p = plot3d.output.point_data 

p.scalars = np.sqrt(np.sum(p.vectors.to_array()**2, axis=-1)) 


或 者 使 用 TVTK 库 中 的 VectorNorm， 它 可 以 计算 输入 数据 的 vectors 数组 中 各 个 矢量 的 长 
度 ， 并 且 将 结果 保存 到 scalars 数组 中 : 


# 读 入 数据 

plot3d = read_data() 

拓 添加 下 面 两 行 代码 

plot3d = tvtk.VectorNorm(input=plot3d.output) 
plot3d.update() 


9.4 TVTK 的 改进 


作为 本 章 的 最 后 一 节 ， 我 们 总 结 一 下 TVTK 库 对 VTK 库 的 改进 。 首 先 看 一 个 使 用 标准 的 
VTK 库 API 显示 圆锥 的 例子 : 


Vvtk_cone_example.py 
这 调用 标准 的 VTK 库 API 绘 制 圆锥 


import vtk 


# 创建 一 个 圆锥 数据 源 

cone = vtk.vtkConeSource( ) 
cone.SetHeight( 3.6 ) 

cone.SetRadius( 1.6 ) 
cone.SetResolution(16) 

# 使 用 PolyDataMapper 将 数据 转换 为 图 形 数据 
coneMapper = vtk.vtkPolyDataMapper( ) 
coneMapper.SetInput( cone.GetOutput( ) ) 
# 创建 一 个 Actor 

coneActor = vtk.vtkActor( ) 

coneActor .SetMapper ( coneMapper ) 

# 用 线 框 模式 显示 圆锥 

coneActor .GetProperty( ) .SetRepresentationTowWireframe( ) 
# 创建 Renderer 和 窗口 

ren1l = vtk.vtkRenderer( ) 
ren1.AddActor( coneActor ) 
ren1.SetBackground( 6.1 , 0.2 ，6.4 ) 
renWin = vtk.vtkRenderWindow( ) 
renWin.AddRenderer( renl ) 
renWin.SetSize(366 ，366) 

# 创建 交互 工具 

iren = vtk.vtkRenderWindowInteractor( ) 
iren.SetRenderWindow( renWin ) 
iren.Initialize( ) 

iren.Start( ) 


此 程序 和 C++ 程序 的 区 别 仅仅 是 没有 声明 变量 的 类 型 ,其 他 的 用 法 完全 和 C++ 的 VTK API 
相同 。 官 方 提供 的 VTK-Python 包 和 C++ 语言 的 接口 相似 , 许多 地 方 没有 体现 出 Python 作为 动 
态 语言 的 优势 ， 可 以 说 标准 的 VIK-Python 库 不 是 Python 风格 的 。 为 了 弥补 这 些 不 足 之 处 ， 
Enthought 公司 开发 的 TVTK 库 进 一 步 对 VTK-Python 进行 封装 ， 它 具有 如 下 优点 : 
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支持 Trait 属性 

支持 元 素 的 Pickle 操作 

API 更 接近 Python 风格 

能 自动 处 理 NumPy 数组 或 列表 对 象 
流水 线 浏览 器 ivtk 

9.4.1 TVTK 的 基本 用 法 


下 面 是 前 面 介绍 过 的 用 TVTK 显示 圆锥 的 程序 : 


from enthought.tvtk.api import tvtk 


cs = tvtk.ConeSource(height=3.6，radius=1.6，resolution=36) 
m= tvtk.PolyDataMapper(input = cs.output) 

a = tvtk.Actor(mapper=m) 

ren = tvtk.Renderer(background=(1, 1, 1)) 

ren.add_actor(a) 

rw = tvtk.RenderWindow(size=(366,366)) 

rw.add_renderer(ren) 

rwi = tvtk.RenderWindowInteractor(render_window=rw) 
rwi.initialize() 

rwi.start() 


这 个 程序 比 标准 VTK 版 本 的 要 简短 许多 ， 从 中 我 们 可 以 看 出 TVTK 的 一 些 重要 改进 : 
e TVTK 库 中 的 类 名 除去 了 前 缀 "vtk"。 有 些 类 名 在 "vtk" 之 后 是 数字 ，TVTK 库 将 对 这 
种 类 名 进行 特殊 处 理 : 如 果 首 字符 为 数字 , 就 用 其 英文 单词 代替 。 例 如 , vtk3DSImporter 


变 成 ThreeDSImporter。 
e 函数 名 按照 Enthought 库 的 惯例 ， 采 用 下 划 线 来 连接 单词 ， 例 如 AddItem 将 变 成 
add item。 
ee 许多 VTK 对 象 的 方法 在 TVTK 中 用 Trait 属性 蔡 代 ， 例 如 下 面 代码 列 出 了 圆锥 实例 
中 的 两 处 改进 : 
m.SetInput(cs.GetOutput()) # VTK 
m.input = cs.output # TVTK 


p.SetRepresentationToWireframe() # VTK 
p.representation = 'w' # TVTK 


。 Trait 属性 可 以 在 创建 对 象 的 同时 通过 关键 字 参 数 进行 设置 ， 这 样 更 便于 程序 的 编写 
在 TVTK 库 的 内 部 实现 中 , 所 有 TVTK 对 象 的 内 部 都 有 一 个 VTK 对 象 , 对 TVTK 对 象 的 
函数 调用 将 转 给 内 部 的 VTK 对 象 来 执行 。 如 果 返 回 值 是 VTK 对 象 ， 它 将 被 封装 成 TVTK 对 


象 返回 。 如 果 方 法 的 参数 是 TVTK 对 象 ， 其 中 的 VTK 对 象 将 作为 值 进行 参数 传递 。 
9.4.2 Trait 属性 


所 有 的 TVTK 类 都 从 HasStrictTraits 继承 ,HasStrictTraits 规定 其 子 类 的 对 象 在 创建 之 后 不 
能 对 不 存在 的 属性 进行 赋值 。 

VTK 中 所 有 和 基本 状态 有 关 的 方法 在 TVTK 中 都 使 用 Trait 属性 表示 。 使 用 Trait 属性 有 
如 下 优点 : 

e 调用 set0 方 法 可 以 一 次 设置 多 个 Trait 属性 ， 例 如 : 


>>> p = tvtk.Property() 
>>> p.set(opacity=0.5, color=(1,8,80), representation="w") 


@ 调用 edit_traits0 或 configure_traits0 可 以 显示 编辑 属性 的 对 话 框 : 
>>> p.edit traits() 


也 可 以 通过 tvtk.to_tvtk0 得 到 任何 TVTK 对 象 所 封装 的 TVK 对 象 ， 在 必要 的 时 候 直接 对 
VTK 对 象 进行 操作 : 


>>> print p.representation 

wireframe 

>>> p_vtk = tvtk.to_vtk(p) 

>>> p_vtk.SetRepresentationToSurface() 
>>> print p.representation 

surface 


还 可 以 通过 TVTK 对 象 的 vtk_obj 属性 获得 其 中 的 VTK 对 象 ， 通 过 tvtk.to_tvtk(p) 则 可 以 
将 VTK 对 象 p 封装 成 TVTK 对 象 。 


9.4.3 序列 化 (Pickling) 
TVTK 对 象 支持 简单 的 序列 化 处 理 。 单 个 TVTK 对 象 的 状态 可 以 被 序列 化 : 


>>> import cPickle 

>>> p = tvtk.Property() 
>>> p.representation="w" 
>>> s = cPickle.dumps(p) 
>>> del p 

>>> q = cPickle.loads(s) 
>>> q.representation 
"wireframe 


但 是 序列 化 仅仅 能 保存 对 象 的 状态 , 对 象 之 间 的 引用 无 法 被 保存 , 因此 TVTK 的 整个 流水 
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线 无 法 用 序列 化 保存 。 
通常 pickleload0 可 创建 新 的 对 象 ， 如 果 希 望 更 新 某 个 已 经 存在 的 对 象 的 状态 ， 可 以 通过 
调用 _setstate 0 来 实现 : 


>>> p = tvtk.Property() 

>>> p.interpolation = "flat" 
>>> d = p._ getstate_() 
>>> del p 

>>> q = tvtk.Property() 

>>> q.interpolation 
"gouraud 

>>> q._ setstate_(d) 

>>> q.interpolation 

St 


9.4.4 ”集合 迭代 


从 tvtk.Collection 继承 的 对 象 可 以 像 标准 的 Python 序列 对 象 一 样 使 用 ， 下 面 的 例子 演示 了 
ActorCollection 对 象 能 够 支持 lan0、append0 以 及 for 循环 : 


>>> ac = tvtk.ActorCollection() 
>>> len(ac) 
8 
>>> ac.append(tvtk.Actor()) 
>>> ac.append(tvtk.Actor()) 
>>> len(ac) 
2 
>>> for a in ac: 
print a 


vtkOpenGLActor (96A99EB8) 


>>> del ac[6] 
>>> len(ac) 
1 


对 比 一 下 VTK 库 相 应 的 版 本 ， 就 能 体会 出 TVTK 库 的 优点 了 : 


>>> ac = vtk.vtkActorCollection() 
>>> ac.GetNumberOfItems() 
8 


>>> ac.AddItem(vtk.vtkActor()) 
>>> ac.AddItem(vtk.vtkActor()) 
>>> ac.GetNumberOfItems() 


>>> ac.InitTraversal() 
>>> for i in range(ac.GetNumberOfItems()): 
print ac.GetNextItem() 


vtkOpenGLActor (85E6A756) 


>>> ac.RemoveItem(6) 
>>> ac.GetNumberOfItems() 
:9 


9.4.5 ”数组 操作 


DataArray 的 所 有 派生 类 和 Python 的 序列 一 样 ， 支 持 迭 代 接口 ， 以 及 __getitem 0)、 
__ setitem 0、_ repr_0、append0， extend0 等 方法 。 此 外 ， 它 还 可 以 通过 from_array0 直 接 用 
Numpy 数组 或 列表 进行 赋值 。 可 以 很 方便 地 将 其 中 保存 的 数据 转换 为 NumPy 数组 。Points 和 
IdList 对 象 也 同样 支持 这 些 特 性 : 
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>>> pts = tvtk.Points() 

>>> p_array = np.eye(3) 

>>> p_array 

array([l 1, 0:> 6.]， 
De 贡 观 厅 为 风 
Lio on lly 

>>> pts.from array(p_array) 

>>> pts.print traits() 


_in_set: 8 

_Vvtk_obj: <vtkCommonPython.vtkPoints vtkobject at 869A@FB6> 
actual_memory_size: 1L 

bounds: (0.0, 1.0, 8.0, 1.0, 0.0, 1.0) 

class_name: "vtkPoints" 

data: [(1.6, 8.0, 0.0), (80.0, 1.0, 0.0), (9.0, 0.0, 1.0)] 
data_type: “double 


number_of_points: 
reference_count: 

>>> pts.to_array() 
eray(lh Ls 907 8:1] 
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[De eA 
[0.,， 9., 1.]]) 


如 果 TVTK 对 象 的 属性 或 方法 能 够 接受 DataAray、Points、IdList、CellArray 等 对 象 ， 那 
么 它 也 同时 能 够 接受 数组 和 列表 : 


>>> points = np.array([[8,8,8],[1,8,8],[9,1,86],[98,8,1]], 'f') 
>>> triangles = np.array([[®,1,3],[8,3,2],[1,2,3],[9,2,1]]) 

>>> values = np.array([1.1, 1.2, 2.1, 2.2]) 

>>> mesh = tvtk.PolyData(points=points, polys=triangles) 

>>> mesh.point data.scalars = values 

>>> mesh.points 

[(8.6, 0.0, 09.0), (1.0, 80.0, 90.0), (6.0, 1.0, 9.0), (9.0, 9.0, 1.0)] 
>>> mesh.polys 

<tvtk_classes.cell array.CellArray object at 89x142D4F66> 

>>> mesh.polys.to_array() 

(| .Mo: Pe. 1]. ee ee, I i "ap J | 

>>> mesh.point data.scalars 
[1.1666666666666661，1.2，2.1666666666888681，2.2666686868866668621] 


虽然 VTK 可 视 化 软件 包 的 功能 很 强大 ，Python 的 TVTK 库 也 很 方便 简洁 ， 但 是 用 这 些 工 
具 快 速 编写 实用 的 三 维 可 视 化 程序 仍然 是 非常 具有 挑战 性 的 。 因 此 ， 基 于 VTK 开发 出 了 许多 
可 视 化 软件 ， 例 如 ParaView、VTKDesigner、Mayavi 等 。 

Mayavi 完全 用 Python 编写 而 成 ， 它 不 但 是 一 个 方便 实用 的 可 视 化 软件 ， 而 且 可 以 方便 地 
用 Python 进行 编写 扩展 ,岁入 到 用 户 编写 的 Python 程序 中 ， 另 外 还 提供 了 面向 脚本 的 mlab 模 
块 ， 以 方便 用 户 快速 绘制 三 维 图 形 。 


10.1 用 mlab 快速 绘图 


和 matplotlib 的 pylab 一 样 ，Mayavi 的 mlab 模块 提供 了 方便 快捷 的 三 维 绘制 函数 。 只 要 将 
数据 准备 好 ， 通 常 只 需要 调用 一 次 mlab 模块 的 绘图 函数 ， 就 可 以 看 到 数据 的 三 维 显示 效果 ， 
非常 适合 在 Python 中 交互 使 用 。 


10.1.1 点 和 线 


三 维 空间 中 独立 的 点 使 用 point3d0 绘 制 , plot3d0 是 将 一 系列 的 点 连接 起 来 ,从 而 绘制 出 三 
维 曲线 。 它 们 可 以 有 3 或 4 个 数组 参数 。 这 些 数组 的 形状 完全 相同 ， 前 3 个 参数 x、y、z 对 应 
点 的 X 轴 、Y 轴 和 ZZ 轴 的 坐标 值 , 如 果 有 第 4 个 参数 *, 它 指定 每 个 坐标 点 对 应 的 数值 (标量 值 )。 
point3d0 的 第 4 个 参数 还 可 以 是 通过 坐标 计算 标量 值 的 函数 。 下 面 是 这 两 个 函数 的 调用 格式 : 


plot3d(x, yy 2, ...) 


plot3d(x, y, z, s, ...) #s 为 保存 每 个 点 对 应 的 标量 值 的 数组 
points3d(x, y, z...) 

points3d(x, y, z, s, ...) #s 为 保存 每 个 点 对 应 的 标量 值 的 数组 
points3d(x, y, z, f, ...) #f 为 计算 每 个 点 对 应 的 标量 值 的 函数 


参数 x、y、z 决定 了 三 维 空间 中 每 个 点 的 坐标 ， 而 每 个 点 对 应 的 数值 则 可 以 用 点 的 颜色 、 
大 小 、 线 的 粗细 等 直观 地 表现 。 

每 个 函数 还 有 许多 关键 字 参 数 , 用 来 设置 各 种 绘图 属性 , 例如 点 的 形状 、 线 的 宽度 、 颜 色 、 
颜色 映射 等 等 。 所 有 这 些 参数 能 够 设置 的 绘图 属性 ， 都 可 以 在 显示 出 图 形 窗口 之 后 ， 在 流水 线 


IAeAeWN 
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对 话 框 中 交互 式 地 修改 。 因 此 本 书 不 对 这 些 参 数 进行 详细 讲解 ， 读 者 可 以 阅读 函数 文档 ， 了 解 
每 个 关键 字 参 数 的 含义 。 

我 们 以 使 用 plot3d0 绘 制 洛 伦 茨 吸 引子 轨迹 为 例 ， 介 绍 如 何 绘制 三 维 空间 中 的 曲线 ， 并 且 使 
用 流水 线 对 话 框 对 图 形 的 各 种 属性 进行 调整 。 下 面 是 绘制 洛 伦 茨 吸引 子 轨迹 的 程序 ， 算 法 请 参 
照 3.4.2 节 ， 默 认 的 绘图 效果 如 图 10-1 所 示 ?( 见 文 前 彩 插 )。 


有 EE mlab_odeint lorenzpy 
总 ”用 plot3d 绘制 洛 伦 区 吸引 子 轨迹 


from scipy.integrate import odeint 
import numpy as np 


def lorenz(w, t, p, r, b): 
X，y，Z = W 
return np.array([p*(y-x), x*(r-z)-y, x*y-b*z]) 


t = np.arange(0, 30, 0.61) 
trackl = odeint(lorenz, (6.0, 1.60, 080.0), t, args=(10.0, 28.6, 3.0)) © 


from enthought.mayavi import mlab © 
mlab.plot3d(track1[:,8], tracki[:,1], track1[:,2], t, tube radius=0.2) © 
mlab. show() 


ils 


PTTTVTTSI EDS 


10-1 使 用 plot3d 函数 绘制 的 洛 伦 茨 吸引 子 轨迹 ， 曲 线 使 用 很 细 的 圆 管 绘制 


@ 使 用 odeint0 得 到 的 轨迹 数据 trackl 是 一 个 二 维 数组 ， 它 的 第 0 轴 的 长 度 是 轨迹 的 点 数 ， 
第 1 轴 的 长 度 为 3， 分 别 为 轨迹 上 每 点 的 X 轴 、Y 轴 和 Z 轴 坐 标 。 

@ 载 入 mlab 模块 之 后 ,调用 @plot3d0 绘 制 轨迹 曲线 。 其 中 ，track1 为 轨迹 的 坐标 数组 ,将 
其 拆 分 为 三 个 轴 上 的 分 量 之 后 ， 传 递 给 plot3d0 进 行 绘图 。 用 时 间 数 组 t 作为 标量 值 数 组 ， 因 此 
轨迹 上 每 个 点 对 应 的 标量 值 就 是 到 达 此 点 的 时 间 。tube radius 参数 用 来 设置 曲线 的 粗细 ， 曲 线 


@ 为 了 更 清楚 地 显示 曲线 ， 实 际 上 用 鼠标 进行 过 放大 和 旋转 操作 。 


实际 上 是 采用 极 细 的 圆 管 绘制 而 成 。 


”由 于 mlab 模块 的 载 入 比较 费时 ， 建 议 在 下 ython(mlab) 或 了 Python(wxPython) 下 月 rm 
命令 执行 绘图 程序 ， 这 样 既 可 以 加 速 程序 的 重复 运行 ， 又 能 在 IPython 环境 下 观察 各 
个 对 象 的 内 容 。 


在 三 维 场景 中 ， 可 以 使 用 键盘 和 上 鼠标 对 场景 照相 机 或 场景 中 的 物体 进行 操作 : 

。 照相 机 模式 ， 默认 模式 ， 在 此 模式 下 ， 所 有 的 鼠标 操作 都 是 针对 照相 机 进行 的 ， 按 
“C” 键 可 切换 到 此 模式 。 

。 角色 模式 : 通过 鼠标 可 以 修改 场景 中 物体 的 方向 和 位 置 , 按 “A” 键 可 切换 到 此 模式 。 

在 照相 机 模式 下 : 

。 旋转 场景 : 使 用 鼠标 左 键 拖 动 或 者 用 键盘 的 方向 键 。 

。 平移 场景 : 使 用 鼠标 中 键 进行 拖 动 或 者 按 住 Shift 键 并 使 用 左 键 拖 动 ， 捉 或 用 Shift+ 方 
向 键 。 

。 缩放 场景 :使 用 鼠标 右键 上 下 拖 动 或 者 使 用 “+” 和 “-” 键 。 

。 滚动 照相 机 : 按 住 Ctrl 键 并 用 左 键 拖 动 。 

窗口 中 的 工具 栏 还 提供 了 从 坐标 轴 的 6 个 方向 观察 场景 、 等 角 投 影 、 切 换 平行 透视 和 成 角 

透视 的 按钮 。 


10.1.2 ”Mayavi 的 流水 线 


工具 栏 中 最 左边 的 图 标 是 打开 Mayavi pipeline 对 话 框 ? 的 按钮 , 单 击 此 按钮 将 打开 如 图 10-2 
所 示 的 对 话 框 。 左 边 的 Pipeline 选项 卡 中 用 树 状 控件 显示 了 构成 场景 的 流水 线 。 此 流水 线 是 
Mayavi 在 TVTK 的 流水 线 之 上 进行 封装 的 结果 。 选 中 流水 线 中 的 某 个 对 象 之 后 ， 窗 口 右 侧 部 
分 将 显示 设置 选中 对 象 用 的 界面 。 让 我 们 看 看 plot3d0 生 成 的 流水 线 中 都 有 哪些 对 象 
EE 


和 
go 


图 10-2 使 用 plot3d 绘制 的 洛 伦 茨 吸引 子 轨迹 的 流水 线 对 话 框 


。 Mayavi Scene 1: 处 于 树 的 最 顶层 的 对 象 表示 场景 。 在 其 配置 界面 中 可 以 设置 场景 的 
背景 色 和 前 景色 、 灯 光 以 及 其 他 一 些 选 项 。 例 如 , 将 背景 色 “Background” 改 为 白色 ， 


@ 后 面 统一 称 之 为 流水 线 对 话 框 。 


公关 可否 滴 斗 出 一 -人 eAeWN 
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将 前 景色 “Foreground” 改 为 灰色 。 可 以 在 了 Python 中 输入 下 面 的 语句 ， 获 取 场 景 对 
象 的 背景 色 : 


>>> s = mlab.gcf() # 首先 获得 当前 的 场景 

>>> S 

<enthought.mayavi.core.scene.Scene object at 86x889D4456> 
>>> s.scene.background 

> (0 .0 10) 


为 了 节省 篇 幅 ,， 书 中 没有 列 出 本 例 涉及 的 各 个 配置 界面 的 截图 。 请 读者 对 照 程序 的 运 
行 界面 阅读 以 下 说 明 。 


e LineSource: 线 数据 源 。 在 其 配置 界面 中 ， 第 一 个 项 目 为 每 个 点 对 应 的 标量 数据 的 名 
称 ， 在 本 例 中 只 有 一 个 名 为 scalars 的 标量 数据 ， 它 就 是 我 们 传递 给 plot3d0 的 第 4 个 
数组 一 表示 轨迹 中 每 点 时 间 的 数组 t。 下 面 的 语句 从 场景 中 获取 LineSource 对 象 ， 
并 且 获 取 其 中 的 各 种 数据 : 

>>> source = s.children[8] # 获得 场景 的 第 一 个 子 节点 ， 也 就 是 LineSource 


>>> source 


<enthought.mayavi.sources.vtk_data_source.VTKDataSource object at @x88726750> 
>>> source.name # 节点 的 名 字 ， 也 就 是 流水 线 中 显示 的 文字 

"LineSource" 

>>> source.data.points # LineSource 中 的 坐标 点 

395 (OO) IO O10) cs 
(-1.1439147656681221，-1.9822677918751635，11.661854166552631)] ， 

length = 3666 

>>> # 每 个 点 对 应 的 标量 数组 ， 它 和 时 间 数 组 t 共享 数据 内 存 

>>> source.data.point_data.scalars 

>>> [8.0, ..., 29.99], length = 3666 


e Stripper: 根据 其 内 部 fter 对 象 的 maximum length 属性 ， 对 线 数据 源 进行 分 段 处 理 。 
在 本 例 中 , 输入 的 线 数据 源 有 3000 个 点 , 而 maximum _length 属性 为 1000, 即 每 1000 
个 点 将 对 应 一 条 线 。 因 此 stripper 对 象 输出 的 PolyData 对 象 中 有 3 条 线 : 


>>> stripper = source.children[8] 

>>> stripper.filter.maximum length 

1666 

>>> stripper.outputs[6].number_of_points 

3666 

>>> stripper.outputs[6] 
<tvtk_classes.poly_data.PolyData object at 6x6A5E2F36> 
>>> stripper.outputs[6].number_of_lines 

3 


e Tube: 将 输入 的 PolyData 数据 中 的 每 条 线 转 换 为 表示 三 维 圆 管 的 PolyData 数据 。 它 


的 配置 界面 中 有 许多 参数 可 以 改变 其 生成 圆 管 的 方式 。 例 如 ， 将 “Vary radius” 设 置 
为 “vary radius by scalar”， 则 圆 管 的 粗细 由 每 个 点 对 应 的 标量 值 决定 。 而 加 粗 的 比 
例 则 由 “Radius 包 ctor” 参 数 决定 ， 我 们 将 其 设置 为 3， 于 是 此 圆 管 最 粗 处 (终点 ) 的 半 
径 是 最 细 处 (起 点 ) 的 3 倍 。 下 面 的 语句 获得 Tube 对 象 ， 并 查看 其 输出 对 象 的 类 型 : 


>>> tube = stripper.children[8] # 获得 Tube 对 象 
>>> tube.outputs[6] # tube 的 输出 是 一 个 PolyData 对 象 ， 它 是 一 个 三 维 圆 管 
<tvtk_classes.poly_data.PolyData object at 6x889E9B76> 


Colors and legends: 在 其 配置 界面 的 “Scalar LUT” 选 项 卡 中 可 以 设置 标量 值 转换 为 
颜色 的 查询 表 (Look Up Table)。 例 如 ， 将 “Lut mode” 改 为 Blues， 于 是 场景 中 圆 管 
的 颜色 变 成 了 从 白色 到 深蓝 色 的 渐变 。 选 中 “Show legend” 选 择 框 ， 场 景 中 便 添 加 
了 一 个 颜色 条 ， 用 来 显示 颜色 和 标量 值 之 间 的 关系 。 下 面 的 语句 获取 我 们 所 选择 的 
颜色 查询 表 : 


>>> manager = tube.children[9] 
>>> manager.scalar_lut manager.lut mode 
"Blues” 


Surface: 将 Tube 输出 的 PolyData 数据 转换 为 最 终 在 场景 中 显示 的 三 维 实体 。 通 过 其 
配置 界面 的 “Actor” 选 项 卡 ， 可 以 对 实体 进行 配置 。 例 如 ， 将 “Representation” 选 
择 为 ‘wireframe”, 并 将 Line width 设置 为 0, 实体 将 采用 细 线 框 模型 显示 。 将 “Opacity” 
设置 为 0.6， 实 体 则 变 为 半 透 明 状 态 。 下 面 的 语句 获取 我 们 刚刚 修改 的 这 两 个 配置 : 


>>> surface = manager.children[8] 
>>> surface.actor.property.representation 
>>> “wireframe 


>>> surface.actor.property.opacity 
>>> 8.59999999999999998 


修改 之 后 的 场景 如 图 10-3 所 示 。 


图 10-3 在 流水 线 对 话 框 中 修改 许多 配置 之 后 的 洛 伦 茨 吸引 子 轨迹 
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通过 前 面 获取 流水 线 中 各 个 对 象 配置 的 程序 , 我 想 读者 应 该 掌握 了 用 程序 配置 这 些 属性 的 
方法 : 

e 先 获 得 场景 对 象 ， 例 如 使 用 mlab.gcf0。 

。 通过 每 个 对 象 的 children 属性 ， 在 流水 线 中 找到 需要 修改 的 对 象 。 

。 当 其 配置 窗口 有 多 个 选项 卡 或 多 个 配置 分 组 框 时 ， 意 味 着 其 属性 可 能 需要 一 级 一 级 
地 获得 。 对 象 的 属性 名 和 界面 上 的 文字 之 间 存 在 很 简单 的 转换 关系 : 首 字母 变 大 写 、 
下 划 线 变 空格 。 例 如 Surface 对 象 的 Actor 选项 卡 ，Property 分 组 框 中 的 “Line width” 
选项 用 程序 描述 就 是 : 


>>> surface.actor.property.line_width 


Mayavi 还 提供 了 脚本 录制 功能 ， 以 方便 我 们 编写 配置 各 种 属性 的 程序 。 单 击 流水 线 对 话 
框 工具 栏 中 的 红色 圆 形 图 标 即 可 开始 脚本 录制 ， 同 时 将 打开 一 个 脚本 对 话 框 。 后面 的 界面 配置 
操作 都 会 被 记录 到 此 脚本 对 话 框 中 。 


10.1.3 ”二 维 图 像 的 可 视 化 


三 维 空间 中 的 曲面 可 以 用 surf0 进 行 绘制 ， 这 实际 上 是 将 二 维 图 像 (数组 ) 绘 制 成 三 维 曲 面 ， 
用 曲面 的 高 度 表示 图 像 中 每 点 的 值 。 下 面 是 绘制 2.2.4 节 中 图 2-5 的 程序 。 


wu mlab_surfpy 
用 surf0 绘 制 三 维 空间 中 的 曲面 


import numpy as np 

from enthought.mayavi import mlab 

x, y = np.ogrid[-2:2:26j，-2:2:26j] @ 

2 三 Xe2 = Yes2) 电 

face = mlab.surf(x, y, z, warp_scale=2) © 
mlab.axes(xlabel="'x', ylabel='y', zlabel='z') @ 
mlab.outline(face) 

mlab.show() 


图 10-4 显示 了 surf0 绘 制 的 曲面 及 其 流水 线 对 话 框 中 的 内 容 ( 见 文 前 彩 插 )。 程 序 中 ，@ 先 通 
过 ogrid 对 象 计算 两 个 形状 分 别 为 (20,1) 和 (1,20) 的 数组 x 和 y。@ 然 后 通过 广播 运算 ， 计 算出 由 
x 和 y 构成 的 等 距 网 格 上 每 点 的 函数 值 z, z 是 一 个 形状 为 (20,20) 的 数组 . @ 接 着 调用 mlab.surf0 
将 数组 z 绘制 成 三 维 空间 中 的 曲面 ， 所 绘制 的 曲面 在 X-Y 平面 上 的 投影 是 一 个 等 距离 的 网 格 。 
@ 最 后 通过 mlab.axes0 和 mlab.outline0， 分 别 在 三 维 场景 中 添加 上 坐标 轴 和 曲面 区 域 的 外 框 。 


ES ET 
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10-4 ”surf0 绘 制 的 曲面 及 其 流水 线 对话 框 


个 和 matplotlib 相反 ， 在 Mayavi 中 ， 二 维 数组 的 第 0 轴 表 示 义 轴 ， 第 1 轴 表示 Y 轴 。 


仔细 观察 曲面 的 颜色 就 会 发 现 ， 颜 色 和 曲面 的 高 度 有 一 一 对 应 的 关系 ， 曲 面 上 的 点 越 高 ， 
其 颜色 越 红 ， 越 低 则 颜色 越 蓝 。 

打开 流水 线 对 话 框 ， 可 以 看 到 数据 源 是 一 个 Aray2DSource 对 象 ， 它 的 输出 是 一 个 TVTK 
的 ImageData 对 象 : 


>>> data = mlab.gcf().children[6] 

>>> img = data.outputs[6] 

>>> img 

<tvtk_classes.image_data.ImageData object at 9x1697F1B6> 


ImageData 对 象 是 一 个 表示 三 维 图 像 的 数据 集 。 在 ImageData 对 象 中 ， 实 际 上 不 保存 空间 
中 每 点 的 坐标 ， 而 是 通过 origin、spacing 和 dimensions 等 属性 计算 出 一 个 三 维 空间 中 的 等 距离 
网 格 ， 网 格 中 每 个 点 对 应 的 标量 值 保 存在 point_data.scalars 中 ， 这 些 值 决定 了 曲面 的 高 度 和 
颜色 。 


>>> img.origin # X 轴 、Y 轴 、Z 轴 的 起 点 
array([-2.，-2.，6.]) 

>>> img.spacing # X 轴 、Y 轴 、Z 轴 上 点 的 间隔 

array([ 6.21652632， 6.21952632， 1. ]) 

>>> img.dimensions # X 轴 、Y 轴 、Z 轴 上 点 的 个 数 
array([26，26， 1]) 

>>> img.point_data.scalars # 每 个 点 对 应 的 标量 值 
[-8.668676925255865，. . .，68.666676925255865]，]length = 466 
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通过 上 面 的 分 析 可 以 看 出 , surf0) 的 功能 是 将 一 个 二 维 图 像 转换 为 三 维 空间 中 的 曲面 .因此 ， 
曲面 上 每 个 点 的 义 轴 、Y 轴 的 坐标 都 是 通过 网 格 配置 计算 出 来 的 。 
于 曲面 的 高 度 与 其 在 X-Y 平 面 上 的 尺寸 可 能 相差 很 大 , 因此 在 流水 线 中 ,在 Array2DSource 
对 象 的 下 面 是 一 个 WarpScalar 对 象 , 它 将 输入 数据 沿 着 Z 轴 方 向 进行 缩放 , 可 以 看 到 其 配置 面 
板 中 的 “Scale factor” 为 2， 它 是 由 surf0 的 warp_scale 参数 决定 的 。WarpScalar 对 象 的 输出 是 
一 个 PolyData 对 象 : 


>>> data.children[6].outputs[6] 
<tvtk_classes.poly_data.PolyData object at 6x11329966> 


流水 线 中 剩 下 的 对 象 请 读者 自己 进行 研究 ， 通 过 研究 流水 线 可 以 了 解 到 Mayavi 内 部 的 组 
织 构造 ， 这 有 助 于 我 们 创建 自己 的 流水 线 结构 ， 进 而 对 复杂 的 数据 进行 可 视 化 。 

如 果 数 据 在 三 个 坐标 轴 上 的 范围 相差 很 大 ， 在 进行 可 视 化 时 就 需要 调整 坐标 轴 的 显示 比 
例 ， 以 达到 更 好 的 可 视 化 效果 。 例 如 在 下 面 的 曲面 函数 中 ，X 轴 方 向 需要 更 大 的 显示 范围 : 


>>> x, y = np.ogrid[-16:16:166j，-1:1:166j] 
>>> z = np.sin(S5*((x/10)**2+y**2)) 


如 果 直 接 使 用 数据 的 范围 进行 显示 ， 效 果 如 图 10-5( 左 ) 所 示 ( 见 文 前 彩 插 )。 虽 然 可 以 很 直 
观 地 看 出 义 轴 的 显示 范围 是 Y 轴 的 10 倍 ， 但 是 却 很 难 观察 曲面 的 一 些 细节 信息 。 


>>> mlab.surf(x，y，z) 
>>> mlab.axes() 


通过 surfO 的 extent 参数 可 以 修改 坐标 轴 的 数据 范围 : 


>>> mlab.surf(x, y, z, extent=(-1,1,-1,1,-0.5,0.5)) 
>>> mlab.axes(nb_labels=5) 


extent 参数 是 一 个 包含 6 个 元 素 的 序列 ， 分 别 用 来 指定 : X 轴 最 小 值 、X 轴 最 大 值 、Y 轴 
最 小 值 、Y 轴 最 大 值 、Z 轴 最 小 值 、Z 轴 最 大 值 。 这 些 值 将 修改 数据 范围 ， 因 此 所 绘制 曲面 的 
和 X 轴 、 立 轴 的 范围 相同 ( 见 文 前 彩 插 )， 而 曲面 在 乙 轴 上 的 高 度 是 X 轴 、Y 轴 范 围 的 一 半 ， 效 果 
如 图 10-5( 中 ) 所 示 ( 见 文 前 彩 插 )。 由 于 extent 参数 改变 的 是 数据 的 范围 , 因此 坐标 轴 上 的 刻度 值 
也 随 之 发 生变 化 。 为 了 解决 这 个 问题 ， 可 以 给 axes0 传 递 Tanges 参数 : 


>>> mlab.axes(ranges=(x.min(),x.max(),y.min(),y.max(),z.min(),z.max()), nb_labels=5) 


Tanges 参数 也 是 一 个 包含 6 个 元 素 的 序列 ， 分 别 指定 三 个 坐标 轴 上 的 刻度 范围 ， 效 果 如 图 
10-5( 右 ) 所 示 ( 见 文 前 彩 插 )。 


图 10-5 ”修改 坐标 轴 的 显示 比例 


除了 surf0 之 外 ,imshow0 和 contour_surf0 也 是 可 视 化 二 维 图 像 的 有 效 工具 。imshow0 将 二 
维 图 像 放 在 三 维 空间 中 显示 ， 它 只 有 一 个 二 维 数组 参数 ， 效 果 和 将 surf0 的 warp_scale 参数 设 
置 为 0 的 效果 一 样 。 下 面 的 语句 将 二 维 数组 z 用 imshow0 绘 制 成 图 ， 效果 如 图 10-6( 左 ) 所 示 ( 见 
文 前 彩 插 )。 


mlab_imshow_contour.py 


x 显示 二 维 图 像 和 等 高 线 


>>> mlab.figure() 
>>> mlab.imshow(z) 


contour surf0 和 surf0) 的 参数 类 似 , 但 可 以 通过 contours 参数 指定 等 高 线 的 数目 或 等 高 值 的 
列表 。 下 面 的 语句 将 曲面 以 20 条 等 高 线 表示 ， 如 图 10-6( 右 ) 所 示 ( 见 文 前 彩 插 )。 


令 三 


10-6 用 imshow 绘制 图 像 ( 左 )、 用 contour_surf 绘制 等 高 线 ( 右 ) 


>>> mlab.figure() 
>>> mlab.contour_surf(x,y,z,warp_scale=2,contours=26) 


实际 上 ， 在 用 surf0 绘 制 曲面 之 后 ， 在 流水 线 对 话 框 中 对 Surface 对 象 进行 如 下 配置 ， 也 可 
以 实现 和 contour_surf0 一 样 的 效果 : 
e 在 “Contours” 选 项 卡 中 ， 选 中 “Enable Contours”。 
e@ 选中 “Anuto contours” 选 项 ， 并 且 指 定 “Number of contours” 为 20， 这 样 会 自动 产生 
20 条 等 高 线 。 
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e@ 也 可 以 不 选中 “Auto contours” 选 项 ， 然 后 手工 添加 等 高 线 。 
或 者 用 下 面 的 代码 进行 等 高 线 设置 ， 其 中 ， 变 量 face 为 surf0 返 回 的 对 象 ， 也 就 是 流水 线 
中 的 Surface: 


>>> face.enable_contours = True 
>>> face.contour.number_of_contours = 26 


10.1.4 网 格 面 


如 果 需 要 绘制 更 复杂 的 三 维 曲面 ， 可 以 使 用 meshO。 下 面 是 使 用 mesh0 绘 制 复杂 曲面 的 程 
序 ， 效 果 如 图 10-7 所 示 ( 见 文 前 彩 插 )。 


a Mlab_mesh.py 
用 mesh 函数 快速 绘制 复杂 的 3D 曲面 


from numpy import pi, sin, cos, mgrid 
from enthought.mayavi import mlab 


# 创建 数据 
dphi, dtheta = pi/86.6，pi/86.6 
[phi, theta] = mgrid[@:pi+dphi*1.5:dphi,8:2*pi+dtheta*1.5:dtheta] 
me, m1, m2, m3, m4, m5, m6, m7 = 4,3,2,3,6,2,6,4 
r= (sin(mo*phi)**m1 + cos(m2*phi)**m3 + © 
sin(m4*theta)**m5 + cos(m6*theta)**m7) 


x = r*sin(phi)*cos(theta) © 
y = r*cos(phi) 
z = r*sin(phi)*sin(theta) 


# 使 用 mesh( ) 绘 制 网 格 面 
s = mlab.mesh(x, y, z) © 


mlab. show() 


图 10-7 使 用 mesh 函数 绘制 的 3D 旋转 体 


全 程序 中 调用 mesh0 绘 制 曲面 ， 它 和 surf0 类 似 ， 三 个 数组 参数 x、y、z 都 是 形状 相同 的 
二 维 数组 。 这 些 数 组 中 相同 下 标的 三 个 数值 组 成 曲面 上 某 点 的 三 维 坐 标 。 点 之 间 的 连接 关系 ( 边 
和 面 ) 由 它们 在 x、y、z 数组 中 的 位 置 关 系 决定 。@ 曲面 上 各 点 的 坐标 在 球 坐 标 系 中 计算 ，@ 然 
后 按照 坐标 转换 公式 将 球 坐 标 系 转换 为 笛 卡 尔 坐标 系 。 

为 了 方便 读者 理解 mesh0 是 如 何 绘制 出 曲面 的 ， 下 面 通过 手工 输入 坐标 的 方式 , 绘制 如 图 
10-8 所 示 的 立方 体 表面 的 一 部 分 ( 见 文 前 彩 插 )。 


a mlab_mesh cube.py 
用 mesh0 绘 制 手工 指定 项 点 坐标 的 立方 体 


a 


oo o0 


10-8 组 成 立方 体 的 各 个 面 和 顶点 坐标 

传递 给 mesh0 的 三 个 数组 x、y、z 的 内 容 如 下 : 
x = [[-1,1,1,-1,-1], 

[-1,1,1,-1,-1]] 
y = [[-1,-1,-1,-1,-1], 

[ 1, 1, 1, 1, 1]] 
z= [[1,1,-1,-1,1], 

[1,1,-1,-1,1]] 
数组 中 下 标 相同 的 三 个 数字 组 成 一 个 三 维 坐 标 ， 因 此 这 三 个 数组 实际 描述 的 坐标 点 为 : 


E 
[C1, -1, 1), (1, -1, 1), (1, -1, -1), (-1, -1, -1), (-1, -1, 1)], 
[C1 1, 1), (1, 1 1), (1, 1, -1), (-1, 1, -1), (-1, 1, 1)] 
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为 了 理解 方便 ， 图 中 将 上 面 的 坐标 点 用 字母 来 表示 : 
[[a,b,c,d,a]， 
[e,f,g,h,e]] 
坐标 点 之 间 的 关系 由 它们 在 数组 中 的 位 置 决定 ， 因 此 下 面 4 组 坐标 点 将 构成 4 个 正方 形 
平面 : 


a，b，f，e -> 顶 面 
b，c，8g，f -> 左面 
c，d，h，8g -> 底面 
d，a，e，h -> 右面 


使 用 mesh0 可 以 很 方便 地 将 二 维 平面 上 的 曲线 绕 着 对 称 轴 进 行 旋转 ， 从 而 得 到 旋转 面 。 下 
面 的 程序 用 meshO 绘 制 由 抛物 线 旋转 之 后 得 到 的 旋转 抛物 面 ， 如 图 10-9 所 示 ( 见 文 前 彩 插 )。 


s mlab_surface_of revolution.py 
污 ”用 mesh0 绘 制 旋转 抛物 面 


import numpy as np 
from enthought.mayavi import mlab 


rho, theta = np.mgrid[8:1:40j, 80:2*np.pi:40j] © 
z= rho*rho @ 


x = rho*np.cos(theta) © 
y = rho*np.sin(theta) © 


s = mlab.mesh(x,y,z) 
mlab. show() 


图 10-9 用 mesh0 绘 制 旋转 抛物 面 


旋转 抛物 面 上 点 的 坐标 很 容易 在 圆柱 坐标 系 (p.6.=) 中 计算 得 出 。@ 首 先 在 (p.9) 平面 中 创 
建 一 个 40x 40 的 二 维 网 格 。@ 通 过 P 计算 出 抛物 面 上 每 点 的 高 度 =。 由 于 是 旋转 面 ， 因 此 高 度 


和 4% 无 关 。 自 将 圆柱 坐标 系 转换 为 直角 坐标 系 ， 得 到 meshO 所 需 的 三 个 数组 。 
使 用 mesh0 还 可 以 绘制 出 前 面 surf0 所 绘制 的 曲面 。 下 面 是 用 meshO 绘 制 曲面 的 程序 : 


a mlab_mesh surfpy 
用 mesh0 绘 制 函 数 曲 面 


import numpy as np 

from enthought.mayavi import mlab 

x, y = np.mgrid[-2:2:26j，-2:2:26j] @ 

z= Xx* np.exp( - Xx**2 - y**2) 

Ee 

c= 2+x+y 四 

pl = mlab.mesh(x, y, z, scalars=c) © 
mlab.axes(xlabel="'x', ylabel='y', zlabel="'z') 
mlab.outline(p1) 

mlab.show() 


@ 这 里 使 用 mgrid 对 象 产生 数组 x 和 y。 这 是 因为 用 mesh0 绘 制 曲面 时 ， 必 须 给 出 曲面 上 
每 点 的 坐标 值 。 因 此 参数 x 和 y 不 能 是 ogrid 产生 的 形状 为 (1,N) 和 (M.1) 的 数组 ， 而 必须 都 是 形 
状 为 (M,N) 的 数组 。 

@ 为 了 演示 mesh0 绘 制 曲面 的 优点 ， 我 们 另外 计算 一 个 二 维 数组 ce，@ 并 且 把 它 传递 给 
mesh0 的 scalars 参数 。 于 是 曲面 上 每 个 点 对 应 的 标量 值 都 将 使 用 数组 中 相应 下 标的 值 。 这 样 
可 以 使 用 数组 对 曲面 上 的 每 个 点 进行 着 色 ， 得 到 一 个 颜色 和 高 度 无 关 的 曲面 ， 相 对 surf0 给 
制 的 曲面 ， 它 能 表达 更 多 的 信息 。 图 10-10 为 程序 的 绘制 效果 及 其 对 应 的 流水 线 ( 见 文 前 彩 插 )。 
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10.1.5 “修改 和 控制 流水 线 
用 surf0 也 可 以 绘制 高 度 和 颜色 不 同 的 曲面 ， 但 是 需要 对 流水 线 进行 一 些 改动 。 


a mlab_surf colorpy 
通过 修改 surf0 的 流水 线 绘制 高 度 和 颜色 不 同 的 曲面 


在 Python(mlab) 中 运行 前 面 介 绍 过 的 绘制 曲面 的 程序 : 


>>> run mlab_surf.py 


我 们 需要 为 每 个 点 添加 一 个 新 的 标量 值 ， 以 控制 它们 的 颜色 。 因 此 ， 首 先 获 得 流水 线 中 
“Array2DSource” 对 象 内 部 的 ImageData 对 象 ?: 


>>> img = mlab.gcf().children[6].image_data 


然后 给 img 添加 一 个 标量 数组 ， 并 且 命 名 为 "color"。 注 意 数组 c 的 第 0 轴 对 应 于 X 轴 ， 而 
第 1 轴 对 应 于 立轴 ， 因 此 需要 将 其 转 置 ，ravel0 方 法 则 将 二 维 数组 转换 为 一 维 数组 : 


>>> c = 2*x + y # 表示 颜色 的 标量 数组 

>>> array_id = img.point_data.add_array(c.T.ravel()) 
>>> img.point_data.get_array(array_id) .name = "color" 
>>> img.point_data.update() 


如 果 读 者 对 为 什么 需要 转 置 有 疑问 ， 查 看 一 下 数组 z 在 ImageData 对 象 中 的 保存 顺序 ， 便 
可 以 看 出 ， 二 维 数组 z 的 数据 是 按照 第 0、1 轴 的 顺序 保存 在 scalars 数组 中 的 : 


>>> z[:3, :3] # 原始 的 二 维 数组 中 的 元 素 

array([[-6.69667693，-6.66148987，-6.66362777]， 
[-8.66133364，-6.66296616，-6.68661578]， 
[-86.662398635，-6.66536864，-6.61678724]]) 

>>># ImageData 中 标量 值 的 顺序 

>>> img.point_data.scalars.to_array()[:3] 

>>> array([-68.66967693，-6.661333684，-6.68239635]) # 和 数组 z 中 第 9 列 的 数值 相同 


接 下 来 需要 在 流水 线 的 “PolyDataNormals ”和 “Colors and legends” 之 间 插 入 一 


SetActiveAttribute 对 象 , 它 将 PolyDataNormals 的 输出 数据 中 名 为 "color" 的 标量 值 设置 为 当前 标 
量 值 。 下 面 先 获得 PolyDataNormals 对 象 : 


>>> normals = mlab.gcf().children[8].children[8].children[6] 


@ 流水 线 中 的 “Amay2Dsource” 实 际 上 是 一 个 AmaySource 对 象 ， 查 看 它 的 源 代码 可 知 ， 它 使 用 image_data 属性 保存 所 创建 的 
ImageData 对 象 。 


通过 下 面 的 语句 可 以 看 到 ,“PolyDataNormals” 输 出 的 PolyData 对 象 的 当前 标量 值 为 数组 
z 中 的 数据 : 


>>> normals.outputs[8].point data.scalars.to _array()[:3] 
array([-8.60667693，-0.60133364，-8.00239635]) 


接 下 来 是 插入 操作 。 首 先 获得 normals 的 下 一 级 对 象 ， 并 将 其 从 children 列表 中 删除 : 


>>> surf = normals.children[8] 
>>> del normals.children[8] 


然后 调用 pipeline.set_active_attribute0， 创 建 一 个 SetActiveAttribute 对 象 ， 并 将 其 添加 到 
normals.children 列表 中 。 通 过 point scalars 参数 将 名 为 "color" 的 数组 设置 为 默认 标量 值 : 


>>> 人 i a ; i 
最 后 将 surf 对 象 添加 到 SetActiveAttribute 对 象 的 子 列表 中 : 


>>> active_attr.children.append(surf) 


现在 ，“PolyDataNormals” 输 出 的 PolyData 对 象 的 当前 标量 值 已 经 变 为 数组 中 的 数据 
了 ， 即 它 的 当前 标量 值 通过 SetActiveAttribute 对 象 被 修改 为 名 为 "color" 的 数组 : 


>>> normals.children[8] .outputs[8].point_data.scalars.to_array()[:3] 
>>> array([-6. ，-5.57894737，-5.15789474] ) 


于 是 后 面 的 颜色 查询 表 将 使 用 数组 e 的 值 作 为 输入 ， 从 而 使 得 曲面 的 高 度 和 颜色 分 别 使 用 
不 同 的 数据 进行 描绘 。 最 终 的 绘图 效果 和 相应 的 流水 线 如 图 10-11 所 示 ( 见 文 前 彩 插 )。 
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也 可 以 不 调用 surf0， 而 直接 创建 流水 线 中 的 每 个 对 象 。 完 整 的 程序 如 下 : 


A mlab_surf color2.py 
讨 _ 通 过 直接 创建 流水 线 来 绘制 高 度 和 颜色 不 同 的 曲面 


import numpy as np 
from enthought.mayavi import mlab 


# 创建 数据 

x, y = np.ogrid[-2:2:26j，-2:2:26j] 

Zz = Xx* np.exp( - x**2 - y**2) # 高 度数 据 

c = 2+x + y # 颜色 数据 

src = mlab.pipeline.array2d_source(x, y, z) 

dataset = src.mlab_source.dataset # 和 src.outputs[8] 相 同 
array_id = dataset.point_data.add_array(c.T.ravel()) 
dataset.point_data.get_array(array_id).name = "color" 
dataset .point_data.update() 


# 创建 流水 线 

warp = mlab.pipeline.warp_scalar(src，warp_scale=2.6) 

normals = mlab.pipeline.poly_data_normals(warp) 

active_attr = mlab.pipeline.set active attribute(normals, 
point_scalars="color") 

surf = mlab.pipeline.surface(active_attr) 


mlab.axes() 
mlab.outline() 
mlab.show() 


直接 创建 流水 线 需 要 开发 者 对 Mayavi 流水 线 上 的 各 种 对 象 十 分 了 解 ， 因 此 建议 读者 首先 
熟悉 Mayavi 的 界面 操作 以 及 各 种 对 象 的 作用 ， 然 后 通过 录制 脚本 逐步 学 习 。 


10.1.6 标量 场 


前 面 介绍 了 如 何 对 一 维和 二 维 数据 进行 可 视 化 ， 下 面 看 看 三 维 数据 的 可 视 化 问题 。 最 简单 
的 三 维 数据 就 是 三 维 图 像 ， 它 可 以 用 一 个 三 维 数组 表示 。 图 像 中 每 个 点 的 三 维 坐标 都 由 它 在 数 
组 中 的 下 标 决定 ， 而 每 个 点 对 应 的 标量 值 则 是 数组 中 对 应 元 素 的 值 。 这 种 三 维 图 像 可 以 用 来 描 
述 标 量 场 ,例如 房间 中 的 温度 分 布 、 材 料 的 密度 分 布 ， 以 及 采用 射线 断层 成 像 (CT) 技 术 采 集 
到 的 人 体 的 内 部 构造 。 

标量 场 有 三 种 可 视 化 方法 : 

。 等 值 面 : 和 二 维 图 像 的 等 高 线 类 似 ， 用 标量 值 相等 的 曲面 ， 显 示 标 量 场 的 形态 。 

。 体 素 呈 像 : 利用 透明 度 和 颜色 直接 呈现 标量 场 的 形态 。 


。 切面 : 通过 对 标量 场 进行 切面 处 理 ， 显 示 在 某 个 切面 上 标量 场 的 形态 。 


使 用 静态 截图 很 难 如 实地 表现 可 视 化 效果 , 为 了 更 深入 地 理解 这 些 可 视 化 工具 , 请 读 
者 在 计算 机 上 运行 本 章 的 程序 ， 并 调整 场景 照相 机 ， 从 各 个 方向 进行 观察 。 


A mlab_scale fieldpy 
痣 使 用 等 值 面 、 体 素 呈 像 和 切面 可 视 化 标量 场 


我 们 用 下 面 的 程序 计算 一 个 含有 两 个 点 电荷 的 电势 场 ， 两 个 点 电荷 分 别 位 于 (-1, 0, 0) 和 (1, 


0, 0) 处 ， 为 了 方便 显示 ， 我 们 只 计算 Z 轴 上 (-2,0) 区 间 的 电势 场 的 值 : 


>>> x, y, z = np.ogrid[-2:2:46j，-2:2:46j，-2:9:46j] 
>>> s = 2/np.sqrt((X-1)**2 + y**2 + Z**2) + 1/np.sqrt((X+1)**2 + y**2 + Z**2) 


使 用 contour3d0 可 以 快速 绘制 此 电势 场 的 等 值 面 : 


>>> surface = mlab.contour3d(s) 


默认 情况 下 ，contour3d0 绘 制 5 个 等 分 标量 值 范围 的 等 值 面 ， 它 不 能 很 好 地 显示 整个 电势 
场 的 结构 ， 因 此 我 们 用 下 面 的 语句 修改 等 值 面 的 范围 、 数 目 及 透明 度 等 属性 : 


>>> surface.contour.maximum_contour = 15 # 等 值 面 的 上 限 值 为 15 
>>> surface.contour.number_of_contours = 16 # 在 最 小 值 到 15 之 间 绘 制 16 个 等 值 面 
>>> surface.actor.property.opacity = 8.4 # 透明 度 为 6.4 


这 些 属性 也 可 以 在 流水 线 对 话 框 中 交互 式 地 进行 
修改 ， 程 序 的 绘制 效果 如 图 10-12 所 示 ( 见 文 前 彩 插 )。 

使 用 等 值 面 对 标 量 场 进行 可 视 化 时 ， 外 面 的 等 值 面 
可 能 会 完全 包含 内 部 的 等 值 面 ， 观 察 不 到 内 部 的 状态 。 
例如 在 本 例 中 ， 如 果 将 Z 轴 的 计算 范围 改 为 (-2, 2)， 并 
且 不 设置 等 值 面 的 透明 度 , 那么 无 论 绘制 多 少 个 等 值 面 ， 
都 只 能 看 到 最 外 层 的 等 值 面 。 

体 素 呈 像 法 用 每 个 点 的 颜色 和 透明 度 对 整个 标量 
场 进行 润色 ， 从 而 能 够 呈现 更 多 的 信息 。 体 素 呈 像 没 有 图 10-12 用 等 值 面 可 视 化 电势 场 
对 应 的 函数 ， 需 要 我 们 自己 创建 流水 线 : 


>>> field = mlab.pipeline.scalar field(s) 
>>> mlab.pipeline.volume(field) 


首先 通过 scalar field0 在 流水 线 中 创建 一 个 标量 场 数据 源 ， 然 后 通过 volume0 将 此 数据 源 
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用 体 素 呈 像 进 行 可 视 化 ， 效 果 如 图 10-13( 左 ) 所 示 ( 见 文 前 彩 插 )。 

于 电势 强度 随 着 距离 的 平方 衰减 ， 因 此 整体 的 润色 效果 并 没有 突出 电势 强 的 部 分 。 为 了 
解决 这 个 问题 ， 可 以 给 volume0 传 递 两 个 关键 字 参 数 一 一 vmin 和 vmax。 它 们 指定 标量 值 的 润 
色 范 围 ， 即 只 绘制 标量 值 在 vmin 到 vmax 之 间 的 区 域 : 


>>> mlab.pipeline.volume(field, vmin=1.5, vmax=10) 


效果 如 图 10-13( 右 ) 所 示 ， 它 很 清楚 地 呈现 出 了 电荷 附近 的 电势 情况 ( 见 文 前 彩 插 )。 


图 10-13 用 体 素 呈 像 法 可 视 化 电势 场 : ( 左 ) 默 认 效 果 ，( 右 ) 通 过 vmin 和 vmax 指定 电势 值 的 润色 范围 


我 们 还 可 以 使 用 切片 工具 观察 标量 场 在 某 个 平面 之 上 的 数据 , 通常 将 切面 工具 和 其 他 的 工 
有 具 同时 使 用 ， 并 且 可 以 直接 在 三 维 场景 中 交互 式 地 改变 平面 的 位 置 和 方向 。 下 面 的 代码 在 流水 
线 中 添加 一 个 标量 切面 , 在 流水 线 中 它 是 “Colors and legends ”的 子 节点 。 通 过 plane_orientation 
参数 指定 切面 的 法 线 方向 为 Y 轴 ， 即 切面 和 YY 轴 垂 直 : 


>>> cut = mlab.pipeline.scalar_cut plane(field.children[8], plane_orientation="y_axes") 


然后 通过 下 面 的 代码 设置 切面 工具 的 一 些 属性 : 


>>> cut.enable_contours = True # 开启 等 高 线 显示 
>>> cut.contour.number_of_contours = 48 # 等 高 线 的 数目 为 46 


切面 工具 的 效果 如 图 10-14 所 示 ( 见 文 前 彩 插 ), 图 中 还 显示 了 添加 切面 工具 之 后 的 流水 线 。 
在 3D 场景 中 可 以 对 切面 工具 进行 如 下 操作 : 

。 拖 动 切面 的 红色 外 框 可 修改 切面 的 位 置 。 

。 拖 动 切面 的 法 线 箭头 可 修改 切面 的 方向 。 

。 拖 动 法 线 和 切面 相交 的 灰色 圆 球 ， 可 改变 切面 的 旋转 中 心 。 


图 10-14 用 切面 工具 观察 电势 场 


10.1.7 矢量 场 


如 果 场 中 每 一 点 的 属性 都 可 以 用 矢量 来 表示 ， 那 么 这 个 场 就 是 一 个 矢量 场 。 对 于 三 维 空间 
中 的 场 ， 每 个 点 对 应 一 个 矢量 , 它 由 XX 轴 、Y 轴 、Z 轴 上 的 三 个 分 量 组 成 。 因 此 需要 3 个 三 
数组 来 表示 矢量 场 ， 这 些 数组 分 别 表 示 矢 量 在 三 个 轴 上 的 分 量 。 下 面 以 洛 伦 茨 吸引 子 为 例 ， 介 
绍 对 矢量 场 进行 可 视 化 的 一 些 基 本 方法 。 


- 办 mlab_vector field.py 
“可视化 洛 伦 欧 吸 引子 的 速度 场 


下 面 的 代码 根据 洛 伦 芯 吸 引子 的 公式 计算 出 X 轴 、Y 轴 、Z 轴 3 个 方向 上 的 速度 分 量 u、 


V、 WwW: 


>>> p, r, b = (10.0, 28.0, 3.0) 
>>> x, y, z = np.mgrid[-17:26:26j，-21:28:26j，6:48:26j] 
>>> U，V，W = p*(y-x), x*(r-z)-y, x*y-b*z 


这 3 个 速度 分 量 构成 一 个 矢量 场 ， 下 面 调用 quiver3d0 将 每 个 点 的 速度 矢量 用 一 个 箭头 来 
表示 : 


>>> vectors = mlab.quiver3d(x, y, z, u, v, w) 


效果 如 图 10-15( 左 ) 所 示 ( 见 文 前 彩 插 )。 由 于 矢量 场 数据 的 网 格 过 密 ， 我 们 看 不 清楚 矢量 场 
的 内 部 结构 。 此 时 可 以 用 下 面 的 语句 ， 修 改 “Vectors” 对 象 的 一 些 属性 以 减少 箭头 的 数量 并 增 
加 箭头 的 长 度 ， 效 果 如 图 10-15( 右 ) 所 示 ( 见 文 前 彩 插 )。 


>>> vectors.glyph.mask_input_points = True # 开启 使 用 部 分 数据 的 选项 
>>> vectors.glyph.mask_points.on_ratio = 28 # 随机 选择 原始 数据 中 的 1726 个 点 进行 描绘 
>>> vectors.glyph.glyph.scale_factor = 5.6 # 设置 箭头 的 缩放 比例 
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图 10-15 ”用 矢量 箭头 可 视 化 矢量 场 


和 标量 场 的 切面 工具 一 样 ， 我 们 也 可 以 对 矢量 场 进行 切面 显示 ， 这 样 可 以 观察 矢量 场 在 某 
个 切面 上 的 形态 : 


>>> src = mlab.pipeline.vector field(x, y, z, u, Vv, w) 

>>> mlab.pipeline.vector_cut_ plane(src, mask_points=2, scale factor=3) 

还 可 以 通过 矢量 场 计算 标量 场 。 下 面 通过 extract_vector_norm0 在 流水 线 中 添加 一 个 
“ExtractVectorNorm” 对 象 ， 它 将 每 个 点 所 对 应 矢量 的 长 度 设置 为 此 点 的 标量 值 : 


>>> magnitude = mlab.pipeline.extract_vector_norm(src) 
于 是 可 以 对 magnitude 表示 的 标量 场 绘制 等 值 面 : 


>>> surface = mlab.pipeline.iso_surface(magnitude) 
>>> surface.actor.property.opacity = 6.3 


图 10-16( 左 ) 是 矢量 切面 工具 和 等 值 面 的 显示 效果 ( 见 文 前 彩 插 )。 下 面 的 语句 分 别 获取 magnitude 
输出 的 ImageData 对 象 的 标量 数组 和 矢量 数组 : 


>>> magnitude.outputs[6].point_data.scalars 

[58.8557548523，. ..，56.6399856567]，length = 8666 

>>> magnitude.outputs[8] .point_data.vectors 

[(8.0, -58.0, 10.0), ..., (80.6, 50.0, -2.0)], length = 8666 


最 后 ， 还 可 以 使 用 flow0 观 察 洛 伦 芯 吸 引子 的 轨迹 。 这 相当 于 绘制 矢量 场 的 场 线 ( 流 线 )， 
空间 中 每 点 对 应 的 矢量 等 于 经 过 此 点 的 场 线 的 切线 方向 : 


>>> mlab.flow(x, y, z, u, v, Ww) 


10-16( 右 ) 是 使 用 flow0 绘 制 的 洛 伦 芯 吸 引子 轨迹 ( 见 文 前 彩 插 )。 以 图 中 球体 上 的 每 个 点 
为 初始 点 计算 它们 对 应 的 场 线 轨迹 。 流 水 线 中 的 “Streamline” 对 象 有 许多 配置 选项 ， 请 读者 自 
行进 行 研究 。 


图 10-16 用 矢量 切面 和 等 值 面 可 视 化 矢量 场 ( 左 )、 用 flow0 观 察 轨迹 ( 右 ) 


10.2 Mayavi 和 TVTK 之 间 的 关系 


Mayavi 建立 在 TVTK 基础 之 上 ， 它 对 TVTK 进行 了 高 度 封装 。 在 实际 使 用 Mayavi 时 ， 
我 们 很 少 需要 直接 和 TVTK 打交道 。 但 是 如 果 读 者 有 兴趣 分 析 Mayavi 的 源 代码 ， 为 其 添加 新 
的 模块 ， 那 么 本 节 的 内 容 可 以 作为 一 个 起 点 。 为 了 更 好 地 掌握 Mayavi， 本 节 将 更 深入 地 研究 
Mayavi 和 TVTK 之 间 的 关系 。 


10.2.1 显示 TVTK 流水 线 


在 前 面 的 介绍 中 ， 我 们 所 看 到 的 流水 线 是 Mayavi 的 流水 线 ， 实 际 上 在 其 内 部 还 创建 了 一 
条 TVTK 的 流水 线 以 生成 最 终 的 场景 。 下 面 的 程序 使 用 TVTK 流水 线 浏览 器 显示 mlab.surfO 
所 创建 的 流水 线 。 


EE mayavi tvtk_pipeline py 


亏 


言 _# 显 示 Mayavi 创 建 的 TVTK 流水 线 


eheW 
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import numpy as np 
from enthought .mayavi import mlab 


x, y = np.ogrid[-2:2:26j，-2:2:26j] 
Ex * npexp( = x**2 = y**2) 


face = mlab.surf(x, y, z, warp_scale=2) 
mlab.axes(xlabel="x', ylabel='y', zlabel='z') 
mlab.outline(face) 


from enthought.tvtk.pipeline.browser import PipelineBrowser © 
b = PipelineBrowser() 

b.root object = [mlab.gcf().scene.render window] @ 

b.show() © 

mlab.show() 

mscene = mlab.gcf() 

tscene = mscene.scene 

rw = tscene.render window 

al = rw.renderers[8].view props[8] 


@ 载 入 TVTK 流水 线 浏览 器 ， 并 创建 一 个 浏览 器 对 象 。@ 将 TVTK 流水 线 的 终点 (一 个 
RenderWindow 对 象 ) 传 递 给 流水 线 浏览 器 的 root_object 属性 , 注意 需要 使 用 列表 将 其 封装 起 来 。 
上 @ 调 用 流水 线 浏览 器 的 show0 方 法 显示 TVTK 流水 线 。 图 10-17 显示 了 mlab.surfO 所 创建 的 
Mayavi 流水 线 和 TVTK 流水 线 。 可 以 看 出 ;TVTK 流水 线 十 分 复杂 ， 而 Mayavi 流水 线 则 简单 
许多 。 


EE] 


TVTK 流 水 绪 


x, CrerGPropersy 十 
图 10-17 surf0 创 建 的 Mayavi 流水 线 和 TVTK 流水 线 


10.2.2 ”两 条 流水 线 之 间 的 关系 


在 Mayavi 流水 线 中 ， 根 节点 是 一 个 Mayavi 场景 ， 可 以 通过 mlab.gcf0 获 得 当前 的 场景 ， 
例如 : 


>>> run mayavi tvtk pipeline.py 

>>> mscene = mlab.gcf() 

>>> mscene 

>>> <enthought .mayavi.core.scene.Scene object at @x897DE638> 
>>> mscene.name # 流水 线 中 根 节点 的 名 称 


"Mayavi Scene 1°" 


Mayavi 场景 的 scene 属性 是 一 个 TVTK 场景 对 象 : 


>>> tscene = mscene.scene 
>>> tscene 
>>> 《enthought .mayavi.core.ui.mayavi_scene.MayaviScene object at 9x6983B636> 


eAeW 


请 不 要 被 它 的 类 名 MayaviScene 所 迷惑 ，MayaviScene 实际 上 是 从 TVTKScene 继承 的 : 


>>> tscene._class_.mro() 
[<class ‘enthought.mayavi.core.ui.mayavi_scene.MayaviScene'>, 
<class “enthought.tvtk.pyface.ui.wx.decorated_scene.DecoratedScene '>， 
<class “enthought.tvtk.pyface.ui.wx.scene.Scene ">， 
<class “enthought.tvtk.pyface.tvtk_scene.TVTKScene '>， 
[[ 省 略 ]] 


代 沙 过 否 痪 寸 出 


TVTKScene 对 TVTK 中 的 RenderWindow 对 象 进行 了 封装 , 可 以 通过 其 render window 属 
性 获得 RenderWindow 对 象 。TVTK 流水 线 以 RenderWindow 对 象 为 终点 ， 因 此 它 是 TVTK 流 
水 线 中 的 根 节点 : 


>>> tscene.render window.__class__ 
<class 'tvtk_classes.win32 open_ gl]_render window.Win320penGLRenderWindow'> 
>>> tscene.render window._ class_.mro() 
[<class 'tvtk_classes.win32 open_g]_render_window.Win320penGLRenderWindow' >, 
<class 'tvtk_classes.open_ gl]_render_window.OpenGLRenderWindow' >, 
<class 'tvtk_classes.render_ window.RenderWindow' >, 


[[ 省 略 ]] 


10-18 显示 了 Mayavi 流水 线 和 TVTK 流水 线 之 间 的 关系 ， 请 读者 参照 此 图 理解 接 下 来 
所 介绍 的 内 容 。 
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图 10-18 ”Mayavi 流水 线 和 TVTK 流水 线 之 间 的 关系 


在 Mayavi 流 水 线 中 , 每 个 对 象 都 通过 children 属性 获得 其 子 对象 的 列表 。 因 此 , 获得 Mayavi 
流水 线 中 的 某 个 对 象 是 非常 容易 的 : 


>>> mscene.children[6] 

<enthought.mayavi.sources.array_source.ArraySource object at 68x882E4D56> 

>>> mscene.children[6].children[6] 
<enthought.mayavi.filters.warp_scalar.WarpScalar object at 6x682F5246> 

>>> mscene.children[6].children[6].children[6] 
<enthought.mayavi.filters.poly_data_normals.PolyDataNormals object at @x884B9BDO> 


而 TVTK 流水 线 就 比较 麻烦 了 , 每 个 对 象 都 需要 通过 不 同 的 属性 获得 其 输入 对 象 。 例如 下 
面 的 代码 从 RenderWindow 开始 , 沿 着 流水 线 依次 访问 输入 对 象 。 其 中 , renderer 和 view_props 
属性 获得 的 是 输入 对 象 的 列表 ， 而 mapper、input、producer_port 和 producer 等 属性 则 直接 获得 
输入 对 象 : 


>>> rw = tscene.render_window 

>>> rw.renderers[6] 

<tvtk_classes.renderer.Renderer object at 6x67E99EA6> 

>>> rw.renderers[86].view_props[6] 

<tvtk_classes.actor.Actor object at 6x868557D56> 

>>> rw.renderers[8].view_props[8] .mapper 
<tvtk_classes.data_set_mapper.DataSetMapper object at 86x88557F96> 
>>> rw.renderers[6].view_props[8].mapper.input 


<tvtk_classes.poly_data.PolyData object at 86x88557456> 
>>> rw.renderers[8].view_props[6].mapper.input.producer_port.producer 
<tvtk_classes.poly_data_normals.PolyDataNormals object at 9x685572A6> 


TVIK 流水 线 中 的 每 个 对 象 都 由 Mayavi 流水 线 中 的 对 象 产生 ， 例 如 下 面 的 代码 可 获得 
Mayavi 流水 线 中 的 PolyDataNormals 对 象 ， 并 显示 其 filter 和 outputs[0] 属 性 ， 可 以 看 到 它们 就 
是 TVIK 流水 线 中 的 对 象 : 


>>> normals = mscene.children[6].children[6].children[6] 

>>> normals 

<enthought .mayavi.filters.poly_data normals.PolyDataNormals object at @x884B9BDO> 
>>> normals.filter 

<tvtk_classes.poly_data_normals.PolyDataNormals object at 6x685572A6> 

>>> normals.outputs[6] 

<tvtk_classes.poly_data.PolyData object at 9x88557456> 


10.3 ”Mayavi 应 用 程序 


Mayavi 还 可 以 作为 一 个 独立 的 应 用 程序 使 用 。 它 的 启动 代码 保存 在 “C:\Python26\Scripts” 

下 ， 如 果 在 PATH 环境 变量 中 添加 了 此 路 径 ， 就 可 以 直接 在 命令 行 中 输入 “mayavi2 ”或 

“mayavi2-script” 来 启动 Mayavi。 也 可 以 通过 Python(x.y) 的 开始 界面 或 者 Windows 的 “开始 ” 
菜单 启动 Mayavi。Mayavi 的 界面 如 图 10-19 所 示 。 
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图 10-19 Mayavi 的 界面 截图 
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在 此 界面 中 ,用 标签 页 的 形式 显示 了 多 个 不 同 功能 的 窗 格 ， 可 以 通过 拖 动 标签 页 和 分 隔 栏 
来 修改 各 个 窗 格 的 位 置 和 大 小 。 界 面 中 各 个 窗 格 的 功能 如 下 : 

@Mayavi 流水 线 浏 览 器 : 管理 多 个 场景 的 流水 线 。 通过 它 的 工具 菜单 可 以 为 流水 线 添加 各 
种 对 象 ， 从 左 到 右 的 工具 按钮 依次 对 应 : 场景 、 数 据 源 、 可 视 化 模块 和 处 理 模块 。@Mayavi 
对 象 编辑 器 : 显示 流水 线 浏览 器 中 被 选中 对 象 的 配置 界面 。 引 场景 窗口 : 流水 线 中 的 每 个 场景 
对 象 都 对 应 一 个 场景 窗口 。@Python 命令 行 : 通过 命令 行 可 以 输入 程序 命令 ， 对 Mayavi 的 流 
水 线 和 各 个 对 象 进行 操作 ， 图 中 使 用 IPython 作为 命令 行 工 具 。@ 对 象 浏览 器 :浏览 在 Python 
命令 行 中 能 够 访问 的 所 有 对 象 。 此 窗 格 在 默认 界面 中 是 隐藏 的 ， 为 了 显示 它 ， 可 以 通过 菜单 
“View” 一 “Others” 打 开 “Show View” 对 话 框 ， 选 择 “Namespace” 后 单 击 OK 按钮 。 

在 Mayavi 的 默认 界面 中 使 用 标准 的 Python 命令 行 ， 我 们 可 以 通过 下 面 的 步骤 将 Mayavi 
的 命令 行 工具 改 为 IPython: 

(1) 首先 运行 Mayavi， 并 选择 菜单 “Tools” 一 “Preferences”， 在 Preferences 对 话 框 的 左 
侧 选择 Mayavi， 并 在 右 侧 的 “Genemal settings” 选 项 区 域 中 选中 “Use ipython”。 

(2) 重启 Mayavi， 查 看 控制 台 的 标签 名 是 否 是 “IPython”。 如 果 不 是 ， 就 进行 步骤 (3)。 

(3) 退出 Mayavi, 在 命令 行 中 输入 下 面 的 命令 ,安装 twisted 和 zope.interface 库 。 如 果 twisted 
安装 失败 ， 也 可 以 去 Twisted 的 官方 网 站 下 载 Windows 的 安装 程序 进行 安装 。 


easy_install twisted 
easy_install zope.interface 


» http://twistedmatrix.com 
Twisted 的 官方 网 站 


10.3.1 操作 流水 线 


通过 流水 线 浏览 器 的 工具 栏 可 以 为 流水 线 添加 场景 、 数 据 源 、 可 视 化 模块 和 处 理 模块 。 也 
可 以 通过 流水 线 中 对 象 的 右键 菜单 为 其 添加 子 对 象 。Mayavi 的 流水 线 由 下 列 4 种 对 象 组 成 : 

e 场景 (Scene): 在 流水 线 浏览 器 中 ， 每 个 根 节点 都 与 一 个 场景 对 象 相对 应 。 

e 数据 源 (Data Source): 场景 的 子 节点 为 数据 源 节点 。 可 以 通过 数据 源 工具 按钮 Mayavi 

对 象 编辑 器 或 场景 节点 的 右键 菜单 来 添加 。 

。 处 理 器 (Filter): 对 数据 源 或 处 理 器 的 输出 进行 处 理 ， 产 生 新 的 处 理 结果 。 

。 显示 组 件 (Module): 将 数据 源 或 处 理 器 的 输出 转换 成 场景 中 的 物体 。 

在 场景 中 可 以 包含 多 个 数据 源 ,每 个 数据 源 经 过 处 理 器 进行 数据 处 理 之 后 ， 由 显示 组 件 在 
场景 中 显示 出 最 终 的 可 视 化 结果 。 

下 面 通过 一 个 实例 介绍 Mayavi 界面 的 使 用 方法 。 我 们 将 对 下 面 两 个 数据 文件 进行 可 视 化 
处 理 : 


data\fire ug.vtu, data\room vis.wrl 
吝 坟 。 要 进行 可 视 化 处 理 的 数据 文件 


其 中 ,，“fire ugvtu” 是 一 个 VTK 的 XML 格式 的 文件 ,其 中 保存 一 个 UnstructuredGrid 数据 
集 ， 它 表示 当 房间 中 的 一 角 着 火 时 ， 房 间 中 各 点 的 温度 以 及 空气 的 流动 速度 。“room vis-wrl” 
文件 是 房间 的 内 部 构造 以 及 着 火 点 的 3D 模型 。 

UnstructuredGrid 数据 集 是 最 一 般 性 的 数据 集 ， 它 的 每 个 点 的 坐标 以 及 点 和 单元 之 间 的 关 
系 都 必须 显 式 指定 。 后 面 我 们 将 使 用 Mayavi 作为 工具 深入 研究 UnstructuredGrid 数据 集 的 构造 。 
现在 ， 首 先 使 用 Mayavi 对 这 两 个 数据 文件 进行 可 视 化 处 理 : 

(1) 开启 一 个 新 的 Mayavi2 应 用 程序 。 选 择 菜单 “File” 一 “Load data” 一 “Open file”， 
在 对 话 框 中 打开 “room vis.wdl” 文 件 。 由 于 此 文件 中 保存 的 是 房间 的 立体 模型 ， 因 此 不 需要 任 
何 显示 组 件 ， 即 可 在 场景 中 显示 出 来 。 

(2) 再 次 使 用 “Open file” 菜 单打 开 “fire ug.vtu” 文 件 。 我 们 需要 为 其 添加 显示 组 件 才能 
进行 可 视 化 ， 因 此 这 时 场景 不 会 有 任何 变化 。 

(3) 当 在 流水 线 中 选中 “fire_ug.vtu” 的 数据 源 节点 时 ，Mayavi 对 象 编辑 器 (名 为 “Mayavi 
object editor” 的 窗 格 ) 中 将 显示 数据 源 的 各 种 选项 , 这 里 可 以 选择 点 的 标量 数据 名 和 矢量 数据 名 。 
我 们 使 用 默认 设置 ， 即 标量 数据 名 为 t+、 矢量 数 据 名 为 uww。t 表示 温度 ，uvw 表示 速度 矢量 。 
而 标量 数据 还 可 以 有 u、v、w 和 mfrac 等 几 种 选择 。 其 中 ，u、v 和 w 为 速度 在 三 个 坐标 轴 上 
的 分 量 ， 它 们 都 是 标量 值 。 

(4) 我 们 首先 为 “fire ug.vtu” 数 据 源 绘制 一 个 外 框 。 选 中 数据 源 节点 ， 然 后 选择 菜单 
“Visualize” 一 “Modules ”一 “Outline”。 这 时 在 数据 源 节 点 下 将 创建 一 个 名 六 “Colors and legends” 
的 颜色 和 图 示 配置 节点 ， 其 下 有 一 个 名 为 “Outline” 的 显示 组 件 。 到 目前 为 止 ， 流 水 线 和 场景 
如 图 10-20 所 示 。 


10-20 ”房间 模型 和 数据 集 的 外 框 


下 面 用 前 面 介绍 过 的 切面 、 等 值 面 及 流 线 对 数据 集 进 行 可 视 化 处 理 。 
(1) 使 用 组 件 菜单 添加 两 个 组 件 : “ScalarCutPlane” 和 “IsoSurface”。 
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CO) 在 流水 线 中 选中 “IsoSurface” 节 点 ， 并 在 Mayavi 对 象 编辑 器 中 修改 其 属性 。 首 先 在 
“Contours” 选 项 卡 中 ， 选 中 “Auto contours” 选 项 ， 并 且 设 置 “Number of countours” 为 15。 
然后 在 “Actor” 选 项 卡 中 将 “Opacity” 设 置 为 0.1。 这 样 就 在 温度 的 取 值 范围 内 自动 构造 了 15 
个 半 透 明 的 等 值 面 。 

(3) 可 以 在 场景 中 直接 修改 切面 的 位 置 和 方向 ， 也 可 以 在 流水 线 中 选中 “ScalarCutPlane” 
节点 ， 然 后 在 Mayavi 对 象 编辑 器 中 修改 其 属性 。 

(4) 选中 “Colors and legends” 节 点 ， 并 且 选 中 “Show legend” 选 项 。 场 景 中 将 出 现 一 个 
颜色 条 ， 它 表示 颜色 和 温度 之 间 的 对 应 关系 。 在 场景 中 可 以 通过 鼠标 调整 颜色 条 的 方向 、 大 小 
和 位 置 。 此 时 的 流水 线 和 场景 如 图 10-21 所 示 ( 见 文 前 彩 插 )。 
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10-21 “使 用 切面 和 等 值 面 观察 温度 分 布 


(5) 选中 “fire ug.vtu” 数 据 源 节 点 ， 在 对 象 编辑 器 中 通过 “Point scalars name” 修 改 与 每 
个 点 对 应 的 标量 数据 名 。 可 以 看 到 场景 中 的 颜色 条 、 切 面 及 等 值 面 都 会 即时 刷新 ， 对 选中 的 标 
量 数据 进行 可 视 化 。 最 后 请 选择 温度 标量 t。 

(6) 使 用 组 件 菜单 添加 “Streamline” 组 件 ( 流 线 组 件 )， 它 可 以 对 表示 速度 的 矢量 数据 进行 
可 视 化 。 场 景 中 将 生成 一 个 作为 流 线 源 的 球体 ， 以 及 从 球体 上 各 点 出 发 的 流 线 轨迹 。 流 线 上 各 
点 的 颜色 用 其 所 在 位 置 的 标量 值 对 应 的 颜色 表示 。 通 过 Mayavi 对 象 编辑 器 可 以 修改 流 线 源 以 
及 流 线 的 形状 、 大 小 等 属性 。 

(7) 数据 集中 没有 表示 速率 (速度 的 大 小 ) 的 标量 数据 。 我 们 可 以 通过 添加 处 理 器 从 速度 矢 
量 数据 计算 出 速率 。 选 中 “fire ugvtu” 数 据 源 节 点 ， 然 后 选择 菜单 “Visualize” 一 “Filters” 
一 “Extract Vector Normm”， 为 数据 集 添加 一 个 名 为 “ExtractVectorNorm” 的 处 理 器 。 

(8) 可 以 为 “ExtractVectorNom” 节 点 添加 切面 和 等 值 面 等 显示 组 件 ， 也 可 以 将 现 有 的 显 
示 组 件 移动 到 它 下 面 。 用 鼠标 左 键 拖 放 “Colors and legends” 节 点 到 “ExtractVectorNom” 节 
点 之 上 。 这 样 一 来 ， 所 有 的 显示 组 件 都 会 对 “下 xtractVectorNorm” 处 理 器 的 输出 数据 进行 可 视 
化 ， 于 是 我 们 得 到 了 速率 的 可 视 化 结果 ， 效 果 如 图 10-22 所 示 ( 见 文 前 彩 插 )。 

(9) 为 了 还 原 成 温度 的 可 视 化 结果 , 只 需要 将 “Colors and legends” 节 点 拖 放 到 “fire ugvtu” 


数据 源 节点 之 上 即 可 。 由 于 “ExtractVectorNorm” 处 理 器 不 改变 数据 集 的 矢量 数据 ， 因 此 流 线 
的 形状 不 会 发 生变 化 ， 而 流 线 的 颜色 会 随 着 标量 数据 的 变化 而 改变 。 

(10) 最 后 , 可 以 使 用 菜单 “File” 一 “Save Visualization” 将 当前 的 可 视 化 状态 保存 成 文件 。 
使 用 菜单 “File” 一 “Load Visualization” 则 可 以 从 文件 恢复 以 前 保存 的 可 视 化 状态 。 
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10-22 ”使 用 切面 、 等 值 面 及 流 线 观察 速率 和 速度 的 分 布 情况 


10.3.2 命令 行 和 对 象 浏览 器 


通过 命令 行 和 对 象 浏览 器 ， 可 以 很 方便 地 查看 和 修改 Mayavi 的 各 个 对 象 的 属性 ， 了 解 对 
象 的 内 部 结构 。 下 面 我 们 用 这 两 个 工具 查看 “fire_ug.vtu” 数 据 源 输 出 的 UnstructuredGrid 数据 
集 的 内 部 构造 。 


本 节 涉 及 数据 集 的 内 部 构造 ,为 了 便于 理解 ,请 读者 首先 仔细 阅读 并 理解 前 面 TVITK 
章节 中 数据 集 的 相关 内 容 。 


首先 打开 对 象 浏览 器 窗 格 ， 其 中 显示 了 4 个 对 象 : 

e application:MayaviVWorkbenchApplication: 表示 当前 应 用 程序 的 对 象 。 

e engine:EnvisageEngine: 在 最 高 层 管理 Mayavi 的 各 种 对 象 。 

e ”explore:Function: 调用 explore(x) 将 打开 一 个 浏览 对 象 x 各 种 属性 的 窗 格 。 

。 ”mayavi:Script: 通过 它 可 以 调用 engine 中 的 一 些 常 用 方法 。 

对 象 浏览 器 中 显示 的 都 是 命令 行 名称 空 间 中 的 对 象 ， 因 此 在 命令 行 窗 格 输入 “engine?” 和 

“mayavi?” 可 以 查看 它们 的 相关 说 明 。 输 入 “explore(application)”， 将 打开 一 个 新 的 窗 格 以 

浏览 application 对 象 的 内 容 。 

如 图 10-23 所 示 , 在 对 象 浏览 器 窗 格 中 一 层 一 层 地 展开 engine 对 象 的 属性 , 直到 找到 VTKXML- 
FileReader 对 象 ， 它 就 是 流水 线 中 的 “fire ugvtu” 数 据 源 节点 。 
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图 10-23 展开 engine 对 象 的 属性 ， 直 到 找到 VTKXMLFileReader 对 象 


进一步 找到 VTKXMLFileReader 对 象 的 子 节点 “.outputs:List(1)”， 它 是 一 个 长 度 为 1 的 
列表 ， 它 的 第 0 个 元 素 就 是 我 们 要 进行 分 析 的 UnstructuredGrid 对 象 。 为 了 方便 观察 它 ， 在 命 
令 行 中 输入 : 


>>> data = engine.current_scene.children[1].outputs[6] 


命令 行 的 名 称 空间 中 多 了 一 个 data 变量 以 表示 UnstructuredGrid 对 象 ， 因 此 对 象 浏览 器 中 
也 同时 多 了 一 个 名 为 “data:UnstructuredGrid” 的 根 节点 。 读 者 可 以 使 用 对 象 浏览 器 研究 一 下 data 
对 象 的 各 个 属性 ， 为 了 表述 方便 ， 下 面 我 们 使 用 命令 行 查看 它 的 各 种 属性 : 


>>> data.points # 保存 所 有 点 的 坐标 
[(8.6，6.6，8.6)，...，(6.9，2.5，2.3999998569488525)]，length = 12323 
>>> data.point_data.number_of_arrays # 每 个 点 对 应 有 6 个 数据 

6 


下 面 的 语句 获得 与 每 个 点 对 应 的 6 个 数据 的 名 称 ， 以 及 默认 的 标量 数据 和 矢量 数据 的 名 称 : 


>>> [data.point data.get_array_name(i) for i in xrange(6)] 
Es Ws Us Vs "Ws "mfrac’] 

>>> data.point data.scalars.name 

‘t! 

>>> data.point_data.vectors.name 

we 


下 面 查看 单元 和 点 之 间 的 关系 : 


>>> data.get_cells().number_of_cells # 获得 单元 个 数 
10462 


>>> data.get_cells().data # 用 来 指定 单元 和 点 之 间 关 系 的 数组 
[8.6，...，12321.6]，length = 94158 

>>> data.get_cel1(6) # 获得 第 9 个 单元 ， 它 是 一 个 六 面体 
<tvtk_classes.hexahedron.Hexahedron object at 8x68CF3126> 
>>> data.get_cell(8).point_ids # 获得 构成 第 6 个 单元 的 点 的 下 标 
[8@, 1, 721, 720, 40, 41, 761, 7608] 


最 后 查看 与 单元 对 应 的 数据 的 个 数 ， 因 为 值 为 0， 所 以 数据 集中 没有 和 单元 对 应 的 数据 : 


>>> data.cell data.number_of_arrays 
8 


通过 上 面 的 分 析 可 以 得 出 如 下 结论 : 

e UnstructuredGrid 对 象 由 12323 个 点 和 10462 个 单元 构成 。 

。 每 个 点 对 应 6 个 数据 ， 其 中 名 为 "uvw" 的 数据 为 矢量 数据 ， 其 他 均 为 标量 数据 。 

e 没有 与 单元 对 应 的 数据 。 

e 点 和 单元 之 间 的 关系 由 CellArray 显 式 指定 。 

为 了 观察 UnstructuredGrid 对 象 的 单元 和 点 之 间 的 关系 ,我 们 使 用 “Extract Edges” 处 理 器 
抽出 每 个 单元 的 边线 ， 然 后 使 用 “Surface” 组 件 将 其 在 场景 中 显示 出 来 。 相 信 读 者 已 经 学 会 了 
如 何 使 用 界面 在 流水 线 中 添加 这 两 个 对 象 , 这 里 为 了 演示 命令 行 的 用 法 , 使 用 命令 行进 行 处 理 : 

>>> from enthought.mayavi.filters.api import ExtractEdges 
>>> from enthought.mayavi.modules.api import Surface 
>>> extract edge = ExtractEdges() 


>>> engine.add filter(extract edge, engine.current_scene.children[1]) 
>>> engine.add module(Surface(), extract edge) 


上 面 的 语句 首先 载 入 ExtractEdges 

和 Surface， 然 后 调用 engine 对 象 的 
add filter0 和 add_module0 方 法 分 别 添 
加 这 两 个 对 象 。 第 一 个 参数 为 被 添加 的 
对 象 ， 第 二 个 参数 为 它 的 上 一 级 对 象 。 
为 了 突出 显示 , 我 们 可 以 用 鼠标 在 流水 
线 中 右 击 某 个 项 目 , 从 弹出 菜单 中 选择 
“Hide/Show”， 暂 时 关闭 一 些 不 相干 


的 组 件 的 显示 。 最 后 的 效果 如 图 10-24 10-24 UnstructuredGrid 对 象 的 单元 边线 
所 示 ( 见 文 前 彩 插 )。 


由 此 可 以 看 出 单元 和 点 之 间 的 关系 是 十 分 规则 的 , 但 是 由 于 房间 内 的 分 隔 墙 所 在 位 置 不 属 
于 数据 集 ， 因 此 在 中 间 有 一 个 断层 ， 为 了 表示 这 个 断层 只 能 使 用 UnstructuredGrid 数据 集 显 式 
地 指定 点 和 单元 之 间 的 关系 。 如 果 没有 这 个 断层 ， 那 么 整个 空间 中 的 数据 可 以 使 用 ImageData 
数据 集 进行 描述 。 
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10.4 将 Mayavi 绊 入 到 界面 中 


Mayavi 除了 能 够 单独 作为 应 用 程序 使 用 之 外 ， 也 可 以 通过 Trait 属性 嵌入 到 使 用 TraitsUI 
制作 的 用 户 应 用 程序 的 界面 中 ， 下 面 的 程序 演示 了 这 一 过 程 : 


from 
from 
from 
from 
from 
from 


# mayavi embed demo.py 
将 Mayavi 场景 谋 入 到 TraitsUI 界面 中 


enthought .traits.api import HasTraits, Button, Instance 
enthought .traits.ui.api import View, Item, VGroup 

enthought .tvtk.pyface.scene_editor import SceneEditor © 
enthought .mayavi.tools.mlab_scene model import MlabSceneModel 
enthought .mayavi.core.ui.mayavi_scene import MayaviScene 
enthought .mayavi import mlab 


class DemoApp(HasTraits): 
plotbutton = Button(u" 绘 图 ") 
# mayavi 场景 
scene = Instance(MlabsceneModel, ()) © 


View = View( 


J 


VGroup( 
# 设置 mayavi 的 编辑 器 
Item(name='scene'’, © 
editor=SceneEditor(scene_class=MayaviScene), 
resizable=True, 
height=256， 
width=466 
)， 
“plotbutton ， 
show_labels=False 
)， 
title=u" 在 TraitsUI 中 嵌入 Mayavi" 


def plotbutton fired(self): 


self.plot() 


def plot(self): 


mlab.test mesh() @ 


app = DemoApp() 


app.configure_traits() 


@ 除 了 从 Traits 和 Traits.UI 模块 导入 之 外 , 还 分 别 从 不 同 的 模块 导入 了 SceneEditor Mlab- 
SceneModel 和 MayaviScene 这 3 个 类 。 

@MlabSceneModel 表示 Mayavi 的 场景 模型 ， 它 在 MVC 模式 中 属于 模型 (ModeD) 对 象 ， 
此 程序 中 用 它 定义 模型 类 DemoApp 的 Trait 属性 scene。 

@scene 属性 在 界面 中 将 呈现 为 一 个 Mayavi 的 三 维 场景 ， 因 此 在 视图 的 Item 定义 中 ， 用 
editor 参数 指定 一 个 编辑 器 ， 让 它 能 正确 显示 scene 所 代表 的 模型 。SceneEditor 是 用 来 创建 场 
景 编辑 器 的 工厂 类 ， 通 过 其 scene_class 参数 指定 真正 创建 场景 对 象 的 类 MayaviScene。 

@ 程 序 中 还 创建 了 一 个 plotbutton 按钮 ， 当 此 按钮 被 单 击 时 ,调用 _plotbutton fired0, 最 终 
会 调用 绘制 场景 的 plot0 方 法 。 在 plot0 方 法 中 ,调用 mlab 模块 的 test_mesh0, 在 场景 中 创建 一 
个 如 图 10-25 所 示 的 很 酷 的 曲面 体 。 

下 面 看 一 个 有 些 实 用 价值 的 程序 。 用 户 输入 一 个 由 x、y、z 变量 构成 的 表达 式 ， 例 如 
“x*xty*y+z*z”。 程 序 使 用 此 表达 式 计算 指定 范围 内 的 三 维 标量 场 ， 并 添加 等 值 面 和 切面 工 
有 具 对 标量 场 进行 可 视 化 。 等 值 面 的 数值 可 以 自动 计算 ， 也 可 以 通过 界面 上 的 滚动 条 进行 配置 ; 
而 切面 的 位 置 和 方向 则 可 以 直接 在 场景 中 用 鼠标 进行 操作 。 由 于 程序 较 长 ， 这 里 仅 列 出 和 绘制 
三 维 场景 有 关 的 代码 。 程 序 的 界面 如 图 10-26 所 示 。 


mayavi embed fieldviewerpy 
写 用 TraitsUI 和 Mayavi 编写 的 三 维 标量 场 观察 器 


a 
图 10.25 将 Mayavi 嵌 入 到 用 TraitsUI 制 作 的 界面 中 图 10-26 三 维 标量 场 观 察 器 :x*y*0.5+2+y*sin(2*x)+y*z*2.0 


def plot(self): 

"绘制 场景 " 

# 产生 三 维 网 格 

x, y, z= np.mgrid[ © 
self.x@:self.x1:1j*self.points, 
self.y6:self.y1:1j*self.points， 
self.z0:self.z1:1j*self.points] 

# 根据 函数 计算 标量 场 的 值 
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scalars = eval(self.function) ©@ 

mlab.clf() # 清空 当前 场景 

# 绘制 等 值 平面 

g = mlab.contour3d(x, y, z, scalars, contours=8, transparent=True) © 
gg.contour.auto_contours = self.autocontour 

mlab.axes() # 添加 坐标 轴 

# 添加 一 个 X-Y 的 切面 

s = mlab.pipeline.scalar_cut_plane(g) 

cutpoint = (self.x@+self.x1)/2, (self.y@+self.y1)/2, (self.z@+self.z1)/2 
s.implicit plane.normal = (86,6,1) # x cut 

s.implicit plane.origin = cutpoint 

self.g =8@ 

self.scalars = scalars 

# 计算 标量 场 的 值 的 范围 

self.ve = np.min(scalars) 

self.v1 = np.max(scalars) 


用 户 单 击 “ 描 画 ” 按 钮 之 后 ， 将 调用 plot0 进 行 绘图 。@ 首 先 计算 三 维 标量 场 的 网 格 ， 注 意 
我 们 使 用 mgrid 快速 产生 三 维 网 格 ， 其 中 的 x0、x1、y0、y1l、z0、z1、points、function 等 都 是 
模型 类 的 Trait 属性 , 可 以 通过 界面 上 的 控件 直接 修改 这 些 属性 的 值 。@ 由 于 用 户 输入 的 三 元 函 
数 是 一 个 字符 串 ， 这 里 用 eval0 对 字符 串 进 行 求 值 ， 在 字符 串 中 可 以 使 用 x、Y、z 等 局 域 变量 。 

四 清空 当前 场景 之 后 ， 调 用 mlab 模块 中 的 contour3d0、axes0、pipeline.scalar cut_ plane0) 
等 在 场景 中 添加 等 值 面 、 坐 标 轴 和 切面 。mlab 模块 默认 对 当前 场景 进行 处 理 ， 如 果 应 用 程序 有 
多 个 场景 需要 分 别 在 其 中 绘图 时 ， 可 以 通过 figure 参数 指定 需要 进行 处 理 的 场景 ， 例 如 : 


mlab.axes(figure=self.scene.mayavi_scene) 


其 中 ，selfscene 是 MlabSceneModel 对 象 ， 其 mayavi_scene 属性 是 真正 表示 场景 的 Scene 
对 象 。 

@ 最 后 更 新 模型 对 象 的 几 个 属性 ， 其 中 变量 g 是 contour3d0 的 返回 值 ， 它 表示 场景 中 的 等 
值 面 。selfv0 和 selfvl 是 标量 场 的 最 小 值 和 最 大 值 ， 它 们 设置 等 值 面 滚动 条 的 取 值 范围 。 

当 与 contour 属性 相对 应 的 滚动 条 控件 (位 于 三 维 场景 的 下 方 ) 的 值 发 生变 化 时 , 将 调用 下 面 
的 _contour_changed0 方 法 修改 保存 等 值 面 数值 的 列表 : 


def _contour_changed(self): 
"等 值 面 的 值 改变 事件 响应 " 
if hasattr(self, "g"): 
if not self.g.contour.auto_contours: 
self.g.contour.contours = [self.contour] 


当 “自动 等 值 ” 复 选 框 控件 改变 时 ,在 autocontour 属性 的 事件 监听 函数 _autocontour_changedO 
中 改变 等 值 面 对 象 g 的 自动 等 值 面 选 项 : 


def _autocontour_changed(self) : 
“自动 计算 等 值 面 的 设置 改变 事件 响应 ” 
if hasattr(self, "g"): 
self.g.contour.auto_ contours = self.autocontour 
if not self.autocontour: 
self._contour_changed() 
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VPython 一 一 制作 3D 演 示 动 画 


VPython 是 一 套 简单 易 用 的 三 维 图 形 库 ， 使 用 它 可 以 快速 创建 三 维 场景 和 动画 。 和 TVTK 
相 比 ， 它 更 适合 于 创建 交互 式 的 三 维 场景 ， 而 TVTK 则 更 适合 于 对 数据 进行 三 维 可 视 化 。 本 章 
将 通过 几 个 实例 介绍 如 何 使 用 VPython 制作 实时 、 交 互 式 的 三 维 动画 演示 程序 。 在 VPython 的 
安装 目录 下 有 数 十 个 例子 ， 并 且 有 很 详细 的 文档 ， 读 者 可 以 参照 这 些 资料 进行 更 深入 的 学 习 。 
下 面 是 VPython 默认 安装 时 的 路 径 : 


Ee \Python26\Lib\site-packages\visual\ 


11.1 场景 、 物 体 和 照相 机 


我 们 从 最 简单 的 例子 开始 ， 下 面 的 程序 创建 一 个 窗口 并 且 在 其 中 显示 一 个 立方 体 , 运行 结 
果 如 图 11-1 的 左 图 所 示 ?。 


from visual import * 
box() 


图 11-1 用 VPython 绘制 的 立方 体 ， 默认 为 俯视 图 ( 左 )， 旋 转 照相 机 之 后 ( 右 ) 


程序 中 ， 首 先 从 visual 模块 载 入 所 有 内 容 ， 然 后 通过 box0 创 建 一 个 立方 体 对 象 ， 创 建 此 


@ 为 了 印刷 方便 ， 实 际 上 在 调用 box0 之 前 设置 了 场景 的 背景 色 为 白色 。 


立方 体 对 象 的 同时 将 显示 一 个 标题 为 “VPython” 的 场景 窗口 。 由 于 我 们 没有 给 box0 传 递 任何 
参数 ， 因 而 立方 体 的 所 有 属性 都 将 使 用 下 面 的 默认 值 : 

e 立方 体 的 中 心 在 三 维 空间 中 的 坐标 为 (0. 0, 0)， 即 坐标 原点 。 

e 立方 体 的 大 小 为 (1, 1, 1)， 即 长 、 宽 、 高 都 为 1 个 单位 。 

。 立方 体 的 颜色 为 白色 。 

窗口 中 显示 的 是 通过 一 个 虚拟 的 照相 机 观察 三 维 场景 时 的 画面 。 而 照相 机 的 默认 位 置 是 从 
Z 轴 的 上 方 往 下 看 (俯视 图 )， 它 自动 调 照相 机 的 位 置 ， 使 它 正 好 能 观察 到 场景 中 的 所 有 物体 。 
于 是 我 们 看 到 的 是 一 个 刚好 充满 场景 窗口 的 正方 形 。 在 场景 窗口 中 ， 同 时 按 住 鼠 标 左右 键 ， 并 
上 下 移动 鼠标 可 以 对 场景 进行 缩放 ; 按 住 鼠标 右键 移动 鼠标 可 以 对 场景 进行 旋转 。 缩 放 和 旋转 
场景 其 实 都 是 对 照相 机 的 位 置 和 方向 进行 修改 ,场景 中 物体 的 位 置 并 没有 发 生变 化 ， 只 是 我 们 
观察 物体 的 距离 和 角度 改变 了 。 

VPython 可 以 在 了 Python 中 交互 式 地 使 用 ， 启 动 Python 之 后 ， 只 需要 先 执行 : 


>>> from visual import * 


然后 就 可 以 在 IPython 中 通过 输入 命令 交互 式 地 创建 三 维 场景 。 需 要 注意 的 是 ， 如 果 关 闭 
了 场景 窗口 ，IPython 也 随 之 结束 。 因 此 不 要 直接 关闭 场景 窗口 ， 而 使 用 下 面 的 语句 将 场景 窗 
口 隐藏 : 


>>> scene.visible = False 


11-2 是 在 IPython 中 交互 式 地 创建 三 维 场景 的 一 个 例子 ， 由 此 可 知 ， 通 过 IPython 能 够 
控制 多 个 场景 窗口 。 
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图 11-2 在 IPython 中 交互 式 地 使 用 VPython 


下 面 的 程序 可 以 帮助 读者 理解 照相 机 的 位 置 和 坐标 轴 之 间 的 关系 , 程序 输出 的 三 维 场景 如 
图 11-3 所 示 。 


vpython _axis py 
六 于 通过 绘制 X、Y、Z 坐标 轴 观 察 照相 机 的 默认 位 置 
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from visual import * 

display(title=u" 坐 标 轴 " .encode("gb2312"), width=3868, height=388, background=(1,1,1)) @ 
arrow(pos=(1,9,6)，axis=(1,6,9)，color=(1,6,6)) © 
arrow(pos=(8,1,6)，axis=(9,1,9)，color=(8,1,6)) 
arrow(pos=(6,6,1)，axis=(9,6,1)，color=(8,6,1)) 


@ 首 先 ， 调 用 display0 创 建 一 个 场景 窗口 ， 并 且 指 定 
了 窗口 的 标题 、 宽 度 和 高 度 。 标 题 必 须 使 用 Windows 系 fT 
统 默认 的 编码 标准 , 因此 为 了 显示 中 文 , 需要 将 Unicode 


转换 为 GB2312 编码 。 
@ 调 用 3 次 arow0, 创建 了 三 个 箭头 物体 ， 通 过 下 | i 
面 的 关键 字 参 数 设置 箭头 的 属性 : 


e 箭头 的 起 点 坐标 通过 pos 参 数 指定 , 分 别 为 (1.0.0)、 
(0.1.0)、(0.0.D)， 坐 标 用 三 个 元 素 的 元 组 表示 。 
这 三 个 坐标 分 别 在 X、Y、Z 坐标 轴 之 上 。 
。 箭头 的 方向 和 长 度 使 用 axis 参数 指定 ， 其 值 为 。 图 11-3 绘制 场景 的 坐标 轴 , 红 、 绿 、 蓝 
三 维 空间 的 矢量 ， 矢 量 也 用 三 个 元 素 的 元 组 表 分 别 表示 XX 轴 、Y 轴 、 Z 轴 
示 ， 程 序 中 使 用 的 三 个 矢量 正好 是 三 个 坐标 轴 的 方向 ， 长 度 都 为 1。 
。 通过 color 参数 指定 箭头 物体 的 颜色 ， 颜 色 也 用 三 个 元 素 的 元 组 表示 ， 每 个 元 素 的 取 
值 都 在 0 到 1 之 间 ， 分 别 表示 红 、 绿 、 蓝 三 种 颜色 的 成 分 。 
通过 观察 图 11-3 中 三 个 箭头 的 位 置 ( 见 文 前 彩 插 ), 我 们 可 以 知道 : 窗口 的 中 心 为 坐标 原点 ， 
义 轴 的 方向 为 从 左 到 右 ，Y 轴 的 方向 为 从 下 到 上 ，Z 轴 的 方向 为 从 屏幕 里 到 屏幕 外 。 此 时 的 照 
相机 位 于 乙 轴 正方 向 上 的 某 点 ， 沿 着 乙 轴 负 方 向 俯视 。 


11.1.1 “控制 场景 窗口 


在 visual 模块 中 有 一 个 全 局 变量 scene， 表 示 默 认 的 场景 窗口 对 象 ， 它 同时 也 是 初始 情况 
下 的 当前 窗口 : 


>>> from visual import * 
>>> scene # 场景 窗口 的 类 型 为 display 
<visual .ui.display object at 6x632BF666> 


必须 在 场景 中 放置 物体 ， 场 景 窗口 才 会 显示 出 来 。 如 果 用 display0 创 建 了 新 的 窗口 对 象 ， 
那么 它 将 变 成 当前 窗口 。 用 box0 等 函数 创建 的 物体 都 将 被 放 到 当前 窗口 中 。 下 面 的 语句 调用 
display0 创 建 了 一 个 新 的 窗口 对 象 : 


>>> scene2 = display(title="'Scene2', x=0, y=0, width=660, height=200, ... 
center=(5,0,80), background=(1,1,1)) 


执行 上 面 的 语句 之 后 ， 将 创建 一 个 标题 为 “Scene2 ”的 窗口 ， 其 左上 角 的 屏幕 坐标 为 (0.0)， 


宽 和 高 分 别 为 600 像素 和 200 像素 。 通 过 center 参数 指定 照相 机 正 对 的 坐标 为 (5.0.0)， 也 就 是 
说 ， 窗 口中 心 点 的 三 维 坐标 为 (5.0.0)。 通 过 background 参数 指定 窗口 的 背景 色 。 要 显示 此 窗口 ， 


我 们 需要 往 里 面 放 物体 : 


>>> box(color=(8.5,6.5,8.5)) 

>>> <visual.primitives.box object at @x8334F898> 
>>> box(pos=(5,8,8), color=color.red) 

>>> <visual.primitives.box object at 6x6334F126> 


我 们 在 场景 中 放置 了 两 个 立方 体 ， 第 一 个 放 在 了 默认 坐标 (0.0.0) 处 ， 其 颜色 为 灰色 ; 第 二 
个 放 在 了 坐标 (5.0.0) 处 ， 颜 色 为 红色 。 红 色 立 方 体 在 窗口 的 中 心 ， 和 我 们 设置 的 窗口 的 center 


参数 一 致 ， 如 图 11-4 所 示 ( 见 文 前 彩 插 )。 


图 11-4 在 场景 中 放置 立方 体 


可 以 调用 窗口 对 象 的 select0 方 法 使 其 成 为 当前 窗口 , 通过 display.get_selected0 可 以 获得 当 


前 的 窗口 对 象 : 


>>> scene.select() 

>>> scene.background=(1,1,1) 

>>> sphere(color=color.yellow) 

<visual .primitives.sphere object at 6x6331D7B6> 
>>> scene2.select() 

>>> sphere(pos=(2.5,8,8), color=color.blue) 
<visual .primitives. sphere object at 6x6331D816> 
>>> display.get_selected() == scene2 

True 


上 面 的 代码 先 将 scene 改 为 当前 窗口 ， 然 后 在 其 中 创建 一 个 黄色 球体 。 接 着 将 scene2 改 为 
当前 窗口 ， 在 其 中 创建 一 个 蓝 色 球体 ， 放 在 坐标 (2.5.0.0) 处 。 最 后 调用 display.get_selected0 检 查 
当前 窗口 是 否 是 scene2。 执 行 这 段 程序 之 后 , 将 出 现 两 个 场景 窗口 ,默认 窗口 的 标题 为 VPython， 


其 中 有 一 个 球体 ;我 们 自己 创建 的 窗口 的 标题 为 “Scene2”， 其 中 有 两 个 立方 体 和 一 个 球体 ， 
如 图 11-5 所 示 ( 见 文 前 彩 插 )。 
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图 11-5 在 第 二 个 场景 中 放置 球体 


窗口 对 象 有 如 下 属性 : 

e foreground: 在 窗口 中 创建 物体 时 采用 的 默认 颜色 ， 默 认为 白色 。 例 如 ， 运 行 
“scene.foreground = color.green” 之 后 ， 窗 口中 新 添加 物体 的 颜色 默认 为 绿色 。 

e background: 窗口 的 背景 色 ， 默 认为 黑色 。 

e ambient: 环境 光 的 颜色 ， 默 认为 color.gray(0.2)，gray0 是 计算 灰 度 的 函数 ， 参 数 为 0 
表示 黑色 ， 为 1 表示 白色 。 

e lights: 场景 中 的 光源 列表 ， 场 景 中 的 默认 光源 为 : 


[distant light(direction=(8.22, 8.44, 8.88), color=color.gray(8.8)), 
distant light(direction=(-8.88, -0.22, -80.44), color=color.gray(8.3))] 


可 以 用 如 下 语句 查看 光源 的 属性 : 


>>> scene.lights[8].direction 
vector(8.218217898235992, 8.436435788471985，08.87287156894397) 


。 cursor.visible: 设置 场景 窗口 中 的 鼠标 是 否 显示 ，False 表示 隐藏 鼠标 。 可 以 用 它 在 拖 
电 物 体 时 隐藏 鼠标 ， 释 放 物体 时 显示 鼠标 。 

。 objects: 场景 中 所 有 可 见 物体 的 列表 ， 被 隐藏 的 物体 和 光源 不 在 此 列表 之 中 。 当 设置 
某 物体 的 visible 属性 为 False 以 隐藏 它 时 ， 其 效果 就 是 将 它 从 此 列表 中 删除 。 下 面 的 
语句 使 场景 中 所 有 的 box 对 象 都 变 成 红色 : 


for obj in scene2.objects: 
if isinstance(obj, box): 
obj.color = color.red 


e@ show_rendertime: 如 果 值 为 True， 就 在 窗口 的 左下 角 显 示 诸如 “cycle:27: 5” 的 字样 。 
这 表示 场景 润色 的 帧 之 间 的 间隔 为 27 毫秒 ， 每 帧 需要 5 毫秒 时 间 润 色 。 这 还 表明 用 
户 的 Python 程序 每 帧 有 22 毫秒 的 处 理 时 间 。 

e stereo: 设置 立体 视觉 。 如 果 读 者 有 双色 三 维 立 体 眼镜 ， 不 妨 试 试 这 个 选项 。 例 如 ， 
设置 scene.stereo="redcyan"， 就 可 以 用 红 - 青 立体 眼镜 观察 场景 。 此 外 还 有 "redblue" 
和 "yellowblue" 等 选项 。 设 置 为 "crosseyed" 时 ,将 产生 左右 两 个 场景 ， 当 左右 眼 交 叉 聚 


焦 到 左右 两 个 图 时 ， 会 产生 立体 效果 。 设 置 为 "active" 时 ， 将 产生 可 以 用 主动 式 快门 
眼镜 观看 的 立体 场景 。 

e stereodepth: 修改 立体 视觉 的 深度 ， 默 认 值 为 0， 设 置 为 2 时 有 最 好 的 立体 效果 。 

e visible: 窗口 是 否 可 见 ， 当 某 个 物体 被 添加 进 窗口 时 ， 窗 口 将 自动 被 设置 为 可 见 。 

e exit: 为 False 时 ， 将 禁止 窗口 的 “关闭 ”按钮 ， 即 无 法 通过 “关闭 ”按钮 关闭 窗口 ， 
默认 为 Tue。 

下 面 所 列 的 一 些 属 性 只 能 在 窗口 隐藏 时 修改 。 因 此 ， 通 常 是 在 用 display0 创 建 窗口 时 通过 

关键 字 参 数 设置 它们 。 如 果 需 要 设置 可 见 窗口 的 属性 ， 需 要 先 通过 visible 属性 将 窗口 隐藏 。 

。 x、y: 指定 窗口 在 屏幕 中 的 位 置 ， 指 定 的 是 窗口 左上 角 的 屏幕 坐标 。 

e width、height: 以 像素 为 单位 的 整个 窗口 的 宽度 和 高 度 ， 包 括 边框 和 标题 栏 。 

。 title: 窗口 标题 栏 中 的 文字 ， 中 文 需要 用 操作 系统 的 默认 编码 标准 。 

e fullscreen: 是 否 采 用 全 屏 显示 ， 如 果 设 置 为 True， 将 不 显示 窗口 的 边框 和 标题 栏 ， 
按 Esc 键 可 退出 全 屏 模式 。 


11.1.2 ”控制 照相 机 


下 面 所 列 的 窗口 对 象 的 属性 用 来 控制 场景 中 照相 机 的 位 置 和 方向 : 

。 center: 照相 机 正 对 的 三 维 空间 的 坐标 点 ， 默 认 值 为 (0.0.0)。 即 使 用 户 旋转 场景 (实际 
上 是 改变 照相 机 的 位 置 )， 照 相机 也 始终 正 对 着 这 个 坐标 。 如 果 修 改 center 的 值 ， 昭 
相机 将 保持 其 方向 不 变 ， 进 行 平 行 移动 使 得 其 正 对 center 坐标 ,效果 如 图 11-6 所 示 。 


饥 避 carWer 风 性 一 


图 11-6 “修改 照相 体 的 center 属性 将 对 照相 机 进行 平行 移动 


e autocenter: 如 果 为 True， 将 自动 调整 center 属性 ， 使 它 成 为 包含 场景 中 所 有 物体 的 
最 小 的 长 方 体 的 中 心 ， 此 最 小 长 方 体 的 各 边 与 X 轴 、Y 轴 、Z 轴 平 行 。 这 样 一 来 ， 
照相 机 将 始终 跟随 场景 中 的 物体 ， 因 此 当 它 为 True 时 ， 场 景 中 任何 物体 的 位 置 发 生 
改变 ， 都 有 可 能 影响 center 属性 。 
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e@ scale、range: 它们 都 是 三 个 元 素 的 元 组 。range 设置 照相 机 所 能 看 到 的 范围 ，scale 
则 为 range 的 倒数 。 例 如 ， 如 果 range 为 (10,10,10)，scale 将 为 (0.1,0.1.0.1)。 

eautoscale: 如 果 设 置 为 True, 将 根据 场景 中 的 物体 自动 调节 ,使 照相 机 能 观察 到 场景 
中 的 所 有 物体 。 

e forward: 照相 机 指向 的 方向 ， 默 认 值 为 (0.0.-D)， 也 就 是 从 照相 机 所 在 位 置 到 center 
坐标 的 方向 矢量 。 用 户 不 能 直接 修改 照相 机 所 在 的 位 置 ， 但 可 以 通过 scene mouse. 
camera 获得 它 。 当 用 户 旋转 场景 时 ， 其 实 就 是 在 修改 forward 属性 。 当 forward 被 修 
改 之 后 ， 照 相机 将 会 改变 其 位 置 ， 使 得 其 方向 和 forward 矢量 平行 。forward 的 默认 
值 为 (0,0,-1)， 因 此 是 从 上 往 下 地 俯视 观察 场景 。 图 11-7 演示 了 forward 属性 对 照相 
机 位 置 的 影响 。 它 将 同时 改变 照相 机 的 位 置 和 方向 ， 使 照相 机 始终 对 准 center 坐标 。 

| 


es 
FY 


center 


11-7 forward 属性 可 改变 照相 机 的 方向 和 位 置 


11.1.3 ”模型 的 属性 


场景 中 的 每 个 三 维 模型 对 象 都 有 一 些 共同 的 属性 和 方法 ， 以 控制 它们 在 场景 中 的 位 置 、 大 
小 、 方 向 及 颜色 等 信息 。 下 面 我 们 以 圆锥 为 例 ， 详 细 介 绍 如 何 使 用 这 些 属性 和 方法 。 
首先 调用 cone0， 在 场景 中 创建 一 个 属性 全 部 为 默认 值 的 圆锥 : 


>>> c = cone() 


上 面 的 语句 会 创建 一 个 白色 的 、 底 面 圆 半径 为 1、 圆 心 为 (0.0.0)、 高 为 1 的 圆锥 ， 其 项 角 
指向 XX 轴 的 正方 向 。 因为 场景 中 照相 机 默认 沿 着 Z 轴 负 方向 观察 物体 , 所 以 我 们 将 看 到 一 个 顶 
角 指向 右 方 的 等 腰 三 角形 。 

模型 的 颜色 由 其 color 属性 决定 ， 也 可 以 通过 red、green、blue 等 属性 直接 访问 color 属性 
中 的 三 个 颜色 分 量 。 由 于 圆锥 < 是 白色 的 ， 因 此 它 的 三 个 颜色 分 量 均 为 1: 


>>> c.color 
(1.96，1.6，1.6) 
>>> c.red 

1.06 


>>> c.green 
1.9 

>>> c.blue 
1.9 


可 以 通过 这 些 颜 色 属 性 修改 物体 的 颜色 ， 例 如 下 面 语句 将 圆锥 改 为 绿色 : 
>>> c.color = (8,1,6) 


模型 的 位 置 由 pos 属性 决定 ， 它 是 表示 向 量 的 vector 对 象 。 也 可 以 通过 模型 的 x、y、z 等 
属性 直接 访问 pos 中 三 个 轴 上 的 分 量 。 而 vector 对 象 本 身 也 具有 x、y、z 等 属性 。 


>>> c.pos 

vector(@, 6, 9) 

>>> c.pos = -1, 0, 8 
> cx 

-1.9 

x32> co posx 

-1.0 


上 面 的 代码 将 圆锥 的 X 轴 坐 标 改 为 -1, 如 果 读 者 没有 改变 照相 机 的 默认 观察 方向 , 那么 会 
看 到 圆锥 向 左 移动 ， 它 的 顶点 将 处 于 场景 窗口 的 正中 心 。 由 此 可 知 ， 圆 锥 对 象 的 pos 属性 决定 
了 圆锥 底面 圆 的 中 心 坐标 。 不 同 模型 的 pos 属性 所 对 应 的 模型 上 的 位 置 有 所 不 同 。 例 如 ， 长 方 
体 box 和 球体 sphere 的 pos 属性 指定 的 是 它们 的 中 心 坐标 。 

axis 和 length 属性 决定 了 圆锥 的 方向 和 长 度 。 这 两 个 属性 是 相互 影响 的 ，axis 属性 是 表示 
向 量 的 vector 对 象 , 而 length 属性 是 向 量 的 长 度 。 不 同 模型 的 axis 属性 所 表示 的 含义 有 所 不 同 。 
对 于 圆锥 来 说 ，axis 属性 是 底面 圆心 坐标 到 项 点 坐标 的 向 量 ， 即 项 点 坐标 为 “cpos + caxis”。 

默认 情况 下 ，axis 属性 为 (1.0.0)， 当 底面 圆心 坐标 为 (1, 0, 0) 时 ， 圆 锥 的 顶点 和 坐标 原点 重 
合 。length 属性 就 是 axis 向 量 的 长 度 ， 向 量 的 长 度 也 可 以 通过 向 量 的 mag 属性 获得 : 


>>> c.axis 
vector(1, 80, 0) 
>>> c.length 
1.6 

>>> c.axis.mag 
1.9 


下 面 语句 将 圆锥 的 方向 改 为 斜 45”， 同 时 还 改变 了 圆锥 的 长 度 : 


59> Esmds a 1, 3 9 
>>> c.length 
1.4142135623738951 
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如 果 修 改 length 属性 ， 将 保持 axis 向 量 的 方向 不 变 而 改变 其 长 度 : 


>>> c.length = 1 
>>> c.axis 
vector(8.707166781186547, 8.767106781186547,，08) 


除了 修改 axis 向 量 之 外 , 还 可 以 调用 rotate0 方 法 改变 模型 的 方向 。rotate0 将 根据 指定 的 旋 
转轴 、 旋 转 中 心 以 及 旋转 角度 对 物体 的 pos 和 axis 属性 进行 修改 。 下 面 的 语句 使 圆锥 绕 过 其 顶 
点 平行 于 Z 轴 的 直线 旋转 45”。angle 参数 指定 以 弧度 为 单位 的 旋转 角度 ，axis 参数 指定 旋转 
轴 的 方向 ， 而 origin 参数 指定 旋转 轴 所 经 过 的 一 点 。axis 和 origin 参数 的 默认 值 分 别 为 模型 的 
axis 和 pos 属性 : 


>>> c.rotate(angle=pi/4，axis=(9,6,1)，origin=c.pos+c.axis) 
>>> c.axis 

vector(8，1，96) 

>>> c.pos 

vector( -0.292893218813453，-8.292893218813452, 8) 


下 面 看 一 个 绘制 类 似 水 雷 模型 的 例子 ， 效 果 如 图 11-8 所 示 。 模 型 中 所 有 圆锥 的 底面 圆心 
十 分 靠近 球体 的 表面 ， 而 圆锥 的 方向 则 和 坐标 原点 到 底面 圆心 的 方向 一 致 。 


图 11-8 用 球 和 圆锥 组 合 而 成 的 水 雷 模型 


S Vpython mine.py 
全 和 水 雷 模型 


from itertools import izip 

import numpy as np 

from visual import * 

scene.background = 1,1,1 # 场景 的 背景 色 
color = 8.7,8.7,6.7 # 模型 颜色 


r = 19.6 # 水 雷 半径 

s = sphere(radius=r*1.62，color=color) © 
# 在 球 坐 标 系 中 计算 半径 为 r 的 球面 上 的 坐标 点 
t, f = np.mgrid[6:pi:5j,9:2*pi:16j] © 
xp = r*np.sin(t)*cos(f) 

yp = r*np.sin(t)*sin(f) 

zp = r*np.cos(t) 


for pos in izip(xp.flat, yp.flat, zp.flat): © 
cone(pos = pos, axis=pos, length=r/5, radius=r/18, color=color) @ 


@ 首 先 创 建 一 个 半径 比 指定 半径 r 稍 大 的 球体 ， 模 型 中 圆锥 的 底面 圆心 都 在 半径 为 T 的 球 
面 上 ， 为 了 让 球体 遮 住 圆锥 的 底面 圆 ， 需 要 让 球体 的 半径 大 一 点 。@ 在 球 坐标 系 中 计算 半径 为 
r 的 球面 上 的 点 。 @ 对 每 个 坐标 点 进行 迭代 , 通过 数组 的 flat 属性 可 获得 一 个 把 数组 当做 一 维 的 
迭代 对 象 ，izip0 则 将 三 个 迭代 对 象 中 的 每 个 值 组 合成 一 个 元 组 进行 迭代 。 

@ 调 用 cone0 创 建 球面 上 的 每 个 圆锥 。 这 里 通过 关键 字 参 数 同时 指定 圆锥 的 pos、axis、 
length、radius、color 等 属性 。 其 中 ,radius 属性 是 圆锥 的 底面 圆 半径 。 当 同时 指定 axis 和 length 
参数 时 ，axis 参数 只 决定 axis 属性 的 方向 ，axis 属性 的 长 度 由 length 参数 指定 。 


11.1.4 三维 模型 
VPython 提供 了 一 些 基 本 的 三 维 模型 以 及 创建 复杂 模型 的 方法 。 下 面 的 程序 在 场景 中 展示 
VPython 所 提供 的 各 种 基本 三 维 模型 ， 效 果 如 图 11-9 所 示 。 


A# vpython objects.py 
读 ”VPython 的 基本 三 维 模型 


图 11-9 VPython 的 基本 三 维 模型 


box(size=(9,6,8.2)，pos=(8,8, -8.1)，color=(1,1,1)) # 地 板 

xy = ((x,y) for x in xrange(-3,4,2) for y in xrange(-2,3,2)) © 
idx = 8 

xy = xy.next() 

sphere(pos=(x,y,8.5)) # 球体 
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xy = xy.next() 

cone(pos=(x,y,8)，axis=(8,8,1)) # 圆锥 

xy = xy.next() 

cylinder(pos=(x,y,8)，axis=(8,8,1)) # 圆柱 

xy = xy.next() 

arrow(pos=(x,y,8)，axis=(8,8,2)，shaftwidth=1) # 箭头 

xy = xy.next() 

convex(pos=[(6,6,-1),(6.5,8.5,6),(-9.5,8.5,86)， 思 # 凸 多 面体 
(8.5,-0.5,0),(-8.5,-0.5,8), (0,0,1)], frame=frame(pos=(x,y,1))) 

xy = xy.next() 

t = np.1linspace(8,6*pi,166) 

pos =np.array([8.65*t*np.sin(t), 8.65*t*np.cos(t), t/3/pi]) 

curve(pos=pos.T，radius=8.65，frame=frame(pos=(x,y,8))) 四 # 曲线 

x,y = xy.next() 

ellipsoid(pos=(x,y,8.5)，size=(2,1.5,1)) # 椭 球 

xy = xy.next() 

helix(pos=(x,y,8)，axis=(9,8,2)，thickness =6.1) # 弹簧 、 线 圈 

x,y = xy.next() 

pos = np.random.normal(scale=0.5, size=(50,3)) 

points(pos=pos，frame=frame(pos=(x,y,1))) @ # 散布 点 

x,y = xy.next() 

pyramid(pos=(x,y,8)，axis=(8,8,2)) # 方 锥 

X,y = xy.next() 

ring(pos=(x,y,0.3), axis=(8,8,1), thickness=8.3, radius=8.8) # 圆 环 

X,y = xy.next() 

text(pos=(x,y,8) ，text="Text"，depth=8.3，up=(6,6,1)，align="center") # 三 维 文字 


首先 ， 在 场景 中 用 box0 创 建 一 个 扁平 的 长 方 体 作为 地 板 。 然 后 @ 创 建 计算 地 板 上 每 个 模 
型 位 置 的 迭代 对 象 xy， 每 次 调用 “xy.next0” 即 可 获得 下 一 个 模型 的 X-Y 平面 上 的 坐标 。 为 了 
让 模型 的 底部 和 地 板 刚好 接触 ， 不 同 模型 的 Z 轴 坐 标 会 有 所 不 同 。 

接 下 来 是 创建 每 个 模型 对 象 的 代码 有 些 模型 除了 用 pos 属性 设置 其 位 置 之 外 , 还 使 用 axis 
属性 设置 其 长 度 和 方向 。 此 外 ， 模 型 还 有 一 些 特殊 的 属性 ， 例 如 arrow 箭头 对 象 有 shaftwidth 
属性 用 来 决定 其 粗细 。 关 于 每 个 模型 的 各 种 属性 的 含义 ， 请 读者 参考 VPython 的 说 明 手 册 。 

下 面 介绍 场景 中 几 个 比较 特别 的 模型 : 

@convex0 创 建 凸 多 面体 , 它 的 pos 属性 是 凸 多 面体 每 个 顶点 的 坐标 列表 。 当 pos 中 的 某 些 
点 使 得 凸 多 面体 无 法 创建 时 ， 这 些 点 将 被 忽略 ， 即 convex0 创 建 包含 pos 中 所 有 点 的 凸 包 ?。 程 
序 中 创建 的 凸 面体 是 一 个 由 6 个 顶点 构成 的 八 面体 。 由 于 pos 属性 用 于 设置 凸 多 面体 的 顶点 坐 
标 ， 因 此 缺少 一 个 对 凸 多 面体 整体 位 置 进行 调整 的 参数 。 这 里 创建 一 个 frame 对 象 ， 并 将 它 传 
递 给 convex0 的 frame 参数 。frame 对 象 可 以 将 多 个 模型 打包 在 一 起 ， 让 它们 一 起 移动 和 旋转 。 
这 里 ， 凸 多 面体 的 顶点 坐标 由 其 pos 属性 及 其 frame 对 象 的 pos 属性 决定 。 


@ 关于 “ 凸 包 ”， 有 精确 的 数学 定义 ， 可 以 比较 直观 地 理解 为 : 凸 包 中 任意 两 个 点 的 连 线 都 在 凸 包 之 内 。 


@@curve0 创 建 三 维 曲线 ， 由 于 曲线 实际 上 是 很 细 的 圆 管 ， 因 此 可 以 通过 raidus 参数 设置 圆 
管 的 半径 。 曲 线 上 的 点 通过 曲线 的 参数 方程 计算 并 传递 给 pos 参数 。 和 凸 多 面体 一 样 ， 我 们 用 
一 个 frame 对 象 对 其 进行 打包 。@point0 创 建 散 列 点 ， 其 用 法 和 curve0 类 似 。 

上 面 的 例子 使 用 frame 对 象 改 变 多 面体 、 曲 线 和 散 列 点 的 位 置 ， 每 个 fame 对 象 中 只 有 一 
个 模型 对 象 。 下 面 我 们 看 一 个 用 frame 对 象 修改 多 个 模型 的 位 置 和 方向 的 例子 。 


y 办 vpython frame.py 
党 < 用 frame 对 象 对 多 个 模型 打包 


f = frame() 

ax = arrow(axis=(1,8,0), frame=f) 
ay = arrow(axis=(9,1,8)，frame=f) 
az = arrow(axis=(9,9,1)，frame=f) 
f.pos = (-9.5，-9.5，6) 
f.rotate(angle=pi/4，axis=(9,6,1)) 


程序 中 首先 创建 一 个 fame 对 象 f, 然后 创建 三 个 坐标 轴 上 的 箭头 对 象 , 并 用 frame 参数 指 
定 它们 所 属 的 fame 对 象 。 最 后 修改 fame 对 象 的 pos 属性 ， 调 用 其 rotate0 方 法 同时 修改 三 个 
箭头 对 象 的 位 置 和 方向 。 

在 Python 中 运行 上 面 的 程序 之 后 ， 我 们 可 以 查看 X 轴 箭 头 的 位 置 和 方向 ， 发 现 它 并 没有 
改变 : 


>>> ax.pos 
vector(@, 8, 6) 
>>> ax.axis 
vector(1, 8, 0) 


为 了 计算 X 轴 箭 头 的 两 个 端点 在 场景 中 的 坐标 ， 可 以 调用 frame 对 象 的 fame to _world0 
方法 : 


>>> f.frame_to_world(ax.pos) # X 轴 箭头 的 起 点 坐标 
vector(-0.5, -6.5, 0) 

>>> f.frame_to_world(ax.pos+ax.axis) # X 轴 箭头 的 终点 坐标 
vector(8.267166781186548，6.267166781186547，6) 


此 外 ，world to_frame( 方 法 可 以 将 场景 坐标 系 中 的 坐标 转换 为 fame 对 象 的 相对 坐标 : 


>>> f.world to_frame((86,9,6)) 
vector(8.767166781186547，5.55111512312578e-617，6) 


可 以 看 出 : 场景 的 坐标 原点 在 frame 对 象 的 X 轴 上 。 
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11.2 制作 动画 演示 


用 VPython 制作 动画 的 简单 之 处 在 于 : 只 要 在 一 个 循环 体 中 不 断 地 修改 场景 中 的 各 个 模型 
以 及 照相 机 的 各 种 属性 ， 即 可 实现 动画 效果 。 本 节 以 两 个 实例 简单 地 对 VPython 的 动画 演示 功 
能 进行 介绍 。 
11.2.1 简单 动画 

首先 看 一 个 简单 动画 的 例子 ， 下 面 是 完整 的 源 程序 ， 效 果 如 图 11-10 所 示 。 


# vpython_simple_animation.py 
完 _# 球 在 两 个 板子 之 间 来 回 移动 的 简单 动画 


from visual import * 


display(title=u" 简 单 动画 " .encode("gb2312")， 
width=5680, height=388, background=(1,1,1)) 


ball = sphere(pos=(-5,8,8), radius=8.5, color=color.red) © 
wall_ right = box(pos=(6,8,8), size=(8.1, 4, 4), color=color.green) © 
wall_left = box(pos=(-6,8,6), size=(8.1, 4, 4), color=color.green) 


dt = 9.65 © 
ball.velocity = vector(6，6，6) @ 


while True: @ 
rate(1/dt) @ 
bal1.pos = ball.pos + ball.velocity*dt @ 
if ball.x > wall_right.x-ball.radius or ball.x < wall left.x+ball.radius: @ 
ball.velocity.x *= -1 


Te .a 


图 11-10 球 在 两 个 板子 之 间 反复 运动 的 简单 动画 


运行 这 段 程序 会 出 现 一 个 有 两 块 绿色 板子 和 一 个 红 球 的 窗口 ， 红 球 在 两 块 板子 之 间 反复 


@ 首 先 使 用 sphere0 创 建 一 个 红色 的 球体 。 通 过 pos 和 radius 参数 设置 球 心 坐标 和 球体 的 半 
径 。@ 两 块 绿色 板子 用 box0 创 建 ， 通 过 size 参数 设置 它 在 久 轴 、Y 轴 、Z 轴 方向 上 的 长 度 。 
使 用 axis 参数 也 可 以 改变 其 大 小 ， 它 和 size 是 互相 影响 的 。 

上 @ 用 变量 dt 表示 动画 中 两 帧 之 间 的 时 间 间 隔 。@ 给 球体 ball 添加 一 个 velocity 属性 ， 我 们 
用 它 保存 球体 的 速度 。 注 意 : velocity 不 是 球体 对 象 的 固有 属性 ， 而 是 我 们 为 它 动态 添加 的 属性 。 

人 @ 开 始 动画 效果 的 循环 ， 不 断 更 新 球体 的 pos 属性 ， 实 现 球体 的 运动 效果 。@ 为 了 控制 动 
画 的 播放 速度 ， 在 循环 中 先 调用 rate0， 它 的 参数 为 每 秒 的 帧 数 。 由 于 dt 为 0.05， 因 此 动画 的 
播放 速度 为 每 秒 20 帧 。rate0 会 让 程序 等 待 足够 长 的 时 间 ， 进 而 使 动画 播放 的 帧 数 接近 指定 的 
帧 数 。 

@ 修 改 球 的 pos 属性 ， 加 上 在 dt 时 间 段 中 球 的 位 移 量 。@ 处 理 球 和 板子 的 碰撞 ， 因 为 pos 
为 球 的 中 心 坐标 ， 而 碰撞 点 在 球 的 表面 ， 因 此 处 理 碰撞 时 还 需要 考虑 球 的 半径 。 当 碰撞 条 件 满 
足 时 ， 只 需要 将 球 的 速度 矢量 进行 反 转 即 可 。 

由 于 球 的 速度 为 6， 两 板 之 间 的 间隔 为 1 2， 因此 球 从 左 板 移 到 右 板 需 要 2 秒 钟 时 间 。 


11.2.2 ”盒子 中 反弹 的 球 
下 面 我 们 看 一 个 完整 的 反弹 动画 程序 。 在 场景 中 放置 6 个 半 透 明 的 盒 面 , 形成 一 个 立方 体 ， 
球体 在 立方 体 的 内 部 运动 , 程序 中 可 以 调整 重力 加 速度 (Z 轴 方 向 的 加 速度 ) 和 反弹 系数 ， 同 时 


还 显示 球 的 速度 矢量 和 运动 轨迹 。 运 行 画 面 如 图 11-11 所 示 。 由 于 程序 较 长 ， 下 面 我 们 对 它 分 
段 进行 解释 。 


vpython_ball_ in_ box.py 
更 球 在 盒子 中 反弹 的 动画 


EE -5 


图 11-11 球 在 封闭 盒子 中 反弹 的 动画 


ball = sphere(pos=(-5,0,0), radius=8.5, color=color.red) 
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wall right = box(pos=(6,0,0), size=(98.1, 12, 12), color=color.green, opacity = 8.2) 
wall left = box(pos=(-6,0,80), size=(98.1, 12, 12), color=color.green, opacity = 9.2) 
wall_front = box(pos=(9,-6,0), size=(12, 9.1, 12), color=color.green, opacity = 9.2) 
wall back = box(pos=(8,6,86), size=(12, 8.1, 12), color=color.green, opacity = 6.2) 
wall_bottom = box(pos=(8,0,-6), size=(12, 12, 08.1), color=color.green, opacity = 6.2) 
wall top = box(pos=(8,8,6), size=(12, 12, 8.1), color=color.green, opacity = 9.2) 


首先 创建 上 下 左右 前 后 6 个 面 以 及 在 盒子 中 反弹 的 球体 。 通 过 opacity 参数 设置 每 个 面 的 
不 透明 度 为 02。0.0 表示 完全 透明 ，1.0 表示 完全 不 透明 。 


dt = 9.65 

g = 9.8 # 重力 加 速度 

f = 9.9 # 反弹 能 量 保持 系数 ，1. 表示 完全 反弹 

ball.velocity = vector(8, 6, 12) © 

bv = arrow(pos = ball.pos, axis=ball.velocity*0.2, color=color.yellow) @ 
ball.trail = curve(color=ball.color) © 


trail_color = 8 # 轨迹 的 颜色 


定义 三 个 常数 dt、g、f, 分 别 表示 每 帧 的 时 间 间 隔 、 重 力 加 速度 和 反弹 参数 。@ 为 球体 ball 
创建 一 个 velocity 属性 ， 存 储 它 的 速度 。@@ 创 建 一 个 箭头 物体 ， 它 的 起 始点 位 置 为 球体 的 中 心 ， 
方向 和 球体 的 速度 方向 相同 ， 我 们 用 它 显示 球体 的 速度 。@ 用 curve0 创 建 一 个 曲线 物体 ， 并 赋 
值 给 球体 的 trail 属性 。 目 前 此 曲线 对 象 还 是 空 的 ， 没 有 曲线 数据 。 我 们 用 此 曲线 描绘 球体 的 运 
动 轨迹 。 初 始 化 部 分 到 此 结束 ， 下 面 的 代码 在 while 循环 体 中 ， 对 动画 的 每 帧 进行 计算 : 


rate(1/dt) 

# 重力 加 速度 可 改变 z 轴 方 向 的 速度 ， 不 存在 反弹 时 修改 速度 
ball.velocity.z -=g* dt @ 

# 根据 速度 修改 球体 的 位 置 

ball.pos += ball.velocity * dt © 


@ 使 用 重力 加 速度 改变 球体 在 Z 轴 方向 的 速度 ,然后 @ 根 据 球体 的 速度 计算 其 最 新 的 位 置 。 


拓 速 度 为 正 时 判断 正方 向 的 盒 面 ， 速 度 为 负 时 判断 负 方向 的 盒 面 

类 处 理 反弹 时 需要 修正 的 球 的 位 置 ， 使 它 正好 和 盒 面 接触 

# 处 理 左 右 盒 面 的 反弹 

if ball.velocity.x > 6 and ball.x >= wall right.x - ball.radius: @ 
ball.x = wall right.x - ball.radius 
ball.velocity.x *= -f 

if ball.velocity.x < 0 and ball.x <= wall left.x + ball.radius: 
ball.x = wall left.x + ball.radius 
ball.velocity.x *= -f 

# 处 理 前 后 盒 面 的 反弹 

if ball.velocity.y > 9 and ball.y >= wall back.y - ball.radius: 


ball.y = wall back.y - ball.radius 
ball.velocity.y *= -f 

if ball.velocity.y < 8 and ball.y <= wall front.y + ball.radius: 
ball.y = wall front.y + ball.radius 
ball.velocity.y *= -f 

# 处 理 上 下 盒 面 的 反弹 

if ball.velocity.z > 6 and bal1.z >= wall top.z - ball.radius: 
ball.z = wall top.z - ball.radius 
ball.velocity.z *= -f 

elif ball.velocity.z < 8 and ball.z <= wall bottom.z + ball.radius: 
ball.z = wall_ bottom.z + ball.radius 
ball.velocity.z *= -f 


上 面 的 3 个 程序 片段 用 来 处 理 球体 和 盒 面 的 碰撞 ，X 轴 、Y 轴 、Z 轴 三 个 方向 的 碰撞 处 理 
方式 相同 ， 这 里 以 X 轴 方 向 为 例 简要 说 明 处 理 碰撞 的 算法 。 当 球体 的 X 轴 方 向 速度 为 正 时 ， 
判断 球体 是 否 和 正方 向 的 盒 面 ( 右 侧 ) 相 撞 ， 如 果 相 撞 就 将 其 和 轴 方 向 的 速度 反 转 ， 并 乘 以 碰撞 
系数 来 模拟 能 量 损失 ， 同 时 修改 球体 的 X 轴 坐 标 ， 使 其 正好 和 右 侧 盒 面 相 接 触 。 球 体 的 X 轴 
方向 速度 为 负 时 ， 和 左 侧 盒 面 进行 碰撞 检测 。 


# 更 新 速度 箭头 的 位 置 和 方向 

bv.pos = ball.pos @ 

bv.axis = ball.velocity*0.2 @ 

# 添加 球 的 轨迹 点 

ball.trail.append( pos = bal1.pos，color = (trail color, 8, 6)) @ 
trail_color += 1.6/36.6*+dt # 36 秒 后 颜色 变 为 全 红 

if trail color > 1.6: trail color = 1.6 


@@ 更 新 箭头 的 位 置 和 方向 以 表示 球体 的 速度 ， 箭 头 的 长 度 和 球体 的 速率 成 正比 。@ 将 球 
体 的 当前 位 置 添加 进 球体 的 轨迹 曲线 。 最 后 更 新 轨迹 的 颜色 ， 这 样 颜色 将 随 着 时 间 逐 渐 由 黑 变 
红 ， 整 个 变化 过 程 需 要 30 秒 时 间 。 


11.3 与 场景 交互 


为 了 和 场景 中 的 物体 进行 交互 ，VPython 提供 了 如 下 方便 实用 的 功能 : 

。 键盘 和 鼠标 事件 的 处 理 。 

。 控件 窗口 和 4 种 控件 (按钮 、 滚 动 条 、 开 关 及 菜单 )， 用 于 制作 简单 的 用 户 界 面 。 

。 绘图 窗口 ， 用 于 绘制 二 维 坐标 图 。 

由 于 篇 幅 受 限 ， 本 书 只 介绍 键盘 和 鼠标 事件 的 处 理 ， 请 读者 参考 VPython 的 文档 和 演示 程 
序 来 自学 其 他 部 分 的 内 容 。 
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11.3.1 ”响应 键盘 事件 


通过 场景 窗口 对 象 的 kb 属性 可 以 获得 按键 信息 。kb.keys 是 窗口 中 等 待 处 理 的 键盘 事件 的 
个 数 ， 调 用 kb.getkey0 可 以 从 键盘 事件 队列 中 获取 一 个 待 处 理 的 事件 。 如 果 队 列 为 空 ，getkey0 
将 一 直 等 待 , 直到 产生 键盘 事件 为 止 。getkey0 的 返回 值 是 一 个 描述 按键 的 字符 串 。 下 面 是 一 个 
简单 的 键盘 事件 测试 程序 ， 可 以 用 它 查看 各 个 按键 的 名 称 。 


a vpython. keyboard.py 
键盘 事件 测试 程序 


from visual import * 
keys = label() # 用 于 显示 文字 的 标签 
while True: 
if scene.kb.keys: # 如 果 有 按键 按 下 
s = scene.kb.getkey() # 获得 按键 信息 


keys.text += s + ", 
print s 


下 面 是 程序 输出 的 一 些 按键 名 称 : 


up, left, down, right, f1, f2, ctrl+a, ctrl+shift+d 


11.3.2 ”响应 鼠标 事件 


鼠标 事件 和 键盘 事件 类 似 , 通过 场景 窗口 对 象 的 mouse 属性 进行 鼠标 事件 的 处 理 。 鼠 标的 
坐标 是 二 维 视图 平面 上 的 一 个 点 ， 在 三 维 空间 中 有 一 条 直线 上 的 点 都 将 投影 到 这 个 位 置 ， 我 们 
称 此 直线 为 鼠标 射线 。scene mouse 是 一 个 mouse_object 对 象 ， 下 面 列 出 它 的 属性 和 方法 。 为 了 
便于 理解 ， 图 11-12 显示 了 鼠标 射线 和 pos、pickpos 等 属性 之 间 的 关系 。 
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图 11-12 鼠标 射线 和 鼠标 各 个 坐标 属性 之 间 的 关系 


e pos: 鼠标 在 三 维 空间 中 的 坐标 ， 此 坐标 是 鼠标 射线 与 经 过 点 scene.center 且 平 行 于 屏 
幕 的 平面 的 交点 。 

e button: 描述 鼠标 按键 的 字符 串 ， 值 可 以 为 None、\eft、Yight、'wheel'。 此 属性 只 有 
在 产生 事件 时 才 不 为 None。 

e pick: 用 鼠标 选中 的 物体 对 象 ， 与 鼠标 射线 相交 的 第 一 个 物体 。 

e pickpos: 鼠标 射线 与 pick 物体 的 表面 的 交点 坐标 。 

e camera: 当前 照相 机 的 位 置 坐标 ， 旋 转 或 缩放 场景 时 会 发 生变 化 。 

e Iay: 从 camera 到 pos 的 单位 方向 矢量 ， 也 就 是 鼠标 射线 的 方向 ， 它 正好 和 窗口 视图 
垂直 。 鼠 标 射 线 在 三 维 空间 中 的 参数 方程 为 cameratt*ray， 其 中 t 是 一 个 大 于 0 的 任 
意 参 数 。 

e alt、ctrl、shift: Alt、Ctl、Shift 三 个 按键 的 状态 。 

e project0: 计算 鼠标 射线 与 任意 平面 的 交点 , 平面 由 表示 法 线 方向 的 normal 参数 和 表 
示 平 面 上 某 点 坐标 的 point 参数 指定 。 因 为 与 屏幕 平行 的 面 的 法 线 方向 为 scene. 
forward， 所 以 下 面 语句 的 计算 结果 与 scene mouse.pos 相同 : 


scene.mouse.project(normal=scene.forward, point=scene.center) 


e events: 待 处 理 的 鼠标 事件 的 数目 。 
e getevent0: 从 鼠标 事件 队列 中 获取 最 早 的 鼠标 事件 。 如 果 队 列 为 空 就 一 直 等 待 事件 
的 发 生 。 
getevent0 返 回 的 事件 对 象 保存 事件 发 生 时 的 鼠标 坐标 , 也 具有 上 述 的 属性 和 方法 。 除 此 之 
外 ， 事 件 对 象 还 有 press、click、drag、drop、release 等 属性 ， 它 们 是 描述 鼠标 按键 的 字符 串 ， 
分 别 是 产生 “ 按 下 ”、“ 单 击 ”、“ 拖 ”、“ 放 ”、“ 松 开 ”5 种 鼠标 事件 的 按钮 名 称 。 


个 建议 只 使 用 鼠标 左 键 作为 用 户 交互 用 ， 因 为 其 他 按键 可 能 会 有 问题 。 
下 面 是 鼠标 事件 的 演示 程序 : 


a vpython_mouse.py 
鼠标 事件 的 演示 程序 


from visual import * 

text = label(pos=(0, -2, 08)) 
sphere(pos=(0,2,0)) 

box(pos = (2, 0, 96)) 

ray = arrow(pos=(9,6,9)，color=(1,6,9)) 


while True: 
rate(36) 
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texts = [] 
for attrname in ["pos", "pick", "pickpos", "camera", "ray"]: 
texts .append("%s=%s" % (attrname, getattr(scene.mouse, attrname))) 
texts.append("project=%s" % 
scene.mouse.project(normal=scene.forward, point=scene.center)) 
text.text =“\n" .join(texts) 
ray.axis = scene.mouse.ray 
if scene.mouse.events > @: 
event = scene.mouse.getevent() 
print "press=%s, click=%s, drag=%s, drop=%s, release=%s" % ( 
event.press, event.click, event.drag, event.drop, event.release 


) 


上 述 程序 将 实时 显示 鼠标 对 象 的 pos、pick、pickpos、camera、ray 等 属性 ， 并 且 用 一 个 箭 
头 表示 鼠标 射线 的 方向 ?。 用 project0 计 算 鼠 标 在 经 过 点 scene.center 且 平 行 于 屏幕 的 平面 上 的 
投影 ， 它 的 值 应 该 和 pos 属性 一 致 。 当 有 鼠标 事件 产生 时 ， 程 序 输出 事件 对 象 的 额外 属性 。 
下 面 的 程序 演示 了 如 何在 场景 中 实现 物体 的 拖 动 。 


-小 Wpython dragpy 
半 于 用 鼠标 拖 动 场景 中 的 物体 


from visual import * 


def drag_plane(mouse): 
"返回 鼠标 射线 与 X-Y 平面 的 交点 " 
return mouse.project(normal=(6,6,1)，point=(6,6,6)) 


scene.range = 5 # 固定 场景 范围 

ball = sphere(pos=(-3,0,0), color=color.cyan) 

cube = box(pos=(+3,0,0), size=(2,2,2), color=color.red) 
box(pos=(8,0,-1), size=(8,8,0.65)) 


pick = None # 当前 鼠标 拖 动 的 物体 


while True: 
if scene.mouse.events: 
mevent = scene.mouse.getevent() © 
if mevent.drag and mevent.pick: # 如 果 是 拖 动 事件 ， 并 且 选 中 了 某 物体 
drag_pos = drag_plane(mevent) @ # 拖 动 的 起 始 位 置 
pick = mevent.pick © 
elif mevent.drop: # 如 果 是 释放 事件 


@@ 由 于 鼠标 射线 的 投影 为 一 个 点 ， 因 此 无 法 直接 绘制 它 - 


pick = None 
if pick: 
# 鼠标 投射 与 X-Y 平面 的 交点 坐标 
new_pos = drag_plane(scene.mouse) @ 
if new_pos != drag_pos: # 如 果 鼠 标 移动 了 
pick.pos += new_pos - drag_pos 号 # 修改 物体 的 位 置 
drag_pos = new_pos # 更 新 拖 动 的 起 始 位 置 @ 


@ 首 先 用 getevent0 获 得 要 处 理 的 鼠标 事件 。 如 果 是 鼠标 拖 动 事件 , 并 且 鼠 标 选中 了 某 个 物 
体 ，@ 就 调用 自 定义 的 drag_plane0 计 算出 鼠标 射线 与 X-Y 平面 的 交点 坐标 ， 将 其 作为 拖 动 的 
起 始 位置 ，@ 并 将 当前 选中 的 物体 用 pick 变量 保存 。 

当 pick 变量 保存 了 某 个 物体 时 ，@ 调 用 drag_plane0 计 算出 当前 鼠标 射线 与 X-Y 平面 的 交 
点 坐标 ，@ 然 后 根据 拖 动 的 起 始 位 置 和 当前 位 置 更 新 被 选中 物体 的 位 置 ，@ 并 将 当前 位 置 作为 
下 次 拖 动 的 起 始 位 置 。 

这 样 能 保证 当 使 用 鼠标 选中 物体 的 任何 位 置 进行 拖 动 时 ， 物 体 都 能 够 平滑 地 移动 ， 不 产生 
位 置 的 跳 变 。 由 于 new_pos 和 drag_pos 都 是 鼠标 射线 在 X-Y 平面 上 的 投影 ， 因 此 物体 的 乙 轴 
坐标 始终 保持 不 变 ， 只 修改 X 轴 、Y 轴 的 坐标 。 通过 修改 drag plane0 中 调用 projectO 时 的 投影 
平面 参数 ， 可 以 在 任意 平面 移动 物体 。 


11.4 用 界面 控制 场景 


VPython 提供 了 一 种 控制 窗口 ， 可 以 放置 按钮 、 开 关 及 滚动 条 等 简单 控件 ， 用 以 实时 设置 
场景 中 的 物体 。 但 是 这 些 控件 不 但 功能 有 限 , 而 且 不 是 标准 的 界面 控件 , 操作 起 来 不 是 很 方便 。 
本 节 介绍 如 何 使 用 TraitsUI 制作 一 个 能 控制 VPython 
场景 的 界面 。 

VPython 和 TraitsUI 各 有 自己 的 独立 窗口 , TraitsUI 
界面 有 自己 的 消息 循环 ， 而 Visual 窗口 有 自己 的 动 
画 控制 和 消息 处 理 循 环 。 因 此 我 们 需要 使 用 多 线程 
或 多 进程 方式 ， 让 这 两 个 循环 互 不 影响 。 下 面 是 使 
用 多 线程 实现 TraitsUI 控制 场景 的 完整 程序 ， 效 果 
如 图 11-13 所 示 。 


图 11-13 用 TraitsUI 的 界面 控制 Visual 场景 


a vpython traitsui.py 
半生 用 TraitsUI 的 界面 控制 场景 


import threading 
from visual import * 
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from enthought.traits.api import * 
from enthought.traits.ui.api import * 


首先 载 入 所 需 的 模块 ， 由 于 程序 使 用 多 线程 实现 动画 和 界面 消息 循环 的 分 离 ， 因 此 我 们 载 
入 了 threading 模块 。 


class VisualTraitsUI(HasTraits): 
acceleration = Range(8.0, 20, 9.8) 
auto_scale = Bool(True) 


View = View( 
Item("acceleration"，label=u" 加 速度 ")， 
Item("auto_scale"，label=u" 自 动 缩放 ")， 
title=u" 动 画 控制 面板 " 

) 


在 VisualTraitsUI 类 中 定义 了 两 个 Trait 属性 一 一 acceleration 和 auto_scale, 并 在 其 内 部 创建 
一 个 View 对 象 ， 定 义 界面 的 显示 。 


def _init (self, *args, **kwargs): 
super(VisualTraitsUI, self)._init (*args, **kwargs) 
self.lock = threading.Lock() © 
self.finish event = threading.Event() @ 
self.init_scene() 

def init scene(self): 
self.scene = display(title="TraitsUI Demo", background=(1,1,1)) 
self.floor = box(length=4, height=8.5, width=4, color=color.blue) 
self.ball = sphere(pos=(8,4,8), color=color.red) 
self.ball.velocity = vector(8,-1,6) 
self.dt = 89.61 
self.g = self.acceleration 
self.scene.autoscale = self.auto scale 


在 初始 化 方法 _init 0 中 ，@ 创 建 了 一 个 线程 锁 对 象 lock，@ 以 及 一 个 Event 对 象 finish_ 
event。 由 于 动画 循环 和 界面 事件 处 理 不 在 一 个 线程 中 , 为 了 防止 两 个 线程 同时 访问 同一 变量 时 
出 现 意 想不到 的 问题 ,使 用 lock 对 程序 进行 互 斥 处 理 。 当 主 界面 关闭 时 ,我 们 将 使 用 finish_event 
通知 动画 循环 结束 运行 。 

在 初始 化 场景 的 方法 init_scene0 中 创建 场景 。 最 后 根据 acceleration 和 auto_scale 属性 ， 设 
置 场景 的 一 些 初始 值 : 


def animation(self) : 
while not self.finish_event.is_set(): © 
rate(166) 


self.lock.acquire() @ 
self.ball.pos = self.bal1.pos + self.ball.velocity*self.dt 
if self.ball.y < 1: 
self.ball.velocity.y = -self.ball.velocity.y 
else: 
self.ball.velocity.y = self.ball.velocity.y - self.g*self.dt 
self.lock.release() @ 
self.scene.visible = False © 
def start_animation(self): 
self.thread = threading.Thread(None, self.animation) 
self.thread.start() 
def end_animation(self): 
self.finish event.set() @ 
self.thread.join() @ 


在 处 理 动画 循环 的 方法 animation0 中 ，@ 首 先 判断 finish_event 属性 是 否 被 设置 ， 如 果 为 
True 就 结束 动画 循环 。@ 在 循环 体 中 ， 使 用 lock 对 象 的 acquire0 和 release() 方 法 将 所 有 处 理 动 
画 计算 的 代码 锁 住 。@ 当 动画 循环 结束 时 ， 设 置 scene.visible 为 False， 从 而 关闭 场景 窗口 。 

在 start_animation0 中 创建 动画 处 理 的 线程 并 开始 运行 。 在 end_animation0 中 ，@ 通 过 设置 
finish_event 通知 线程 结束 循环 ，@ 然 后 调用 threadjoin0 等 待 线程 结束 。 这 两 个 方法 将 在 界面 显 
示 之 前 和 关闭 之 后 调用 。 


def _acceleration_changed(self) : 
self.lock.acquire() 
self.g = self.acceleration 
self.lock.release() 

def _auto_scale_changed(self) : 
self.scene.autoscale = self.auto_scale 


当 用 户 在 界面 中 修改 了 “加 速度 ”和 “自动 缩放 ”的 设置 时 ，acceleration 和 auto_scale 属 
性 的 值 将 发 生 改 变 ， 从 而 调用 它们 的 事件 处 理 方法 。 注 意 ， 我 们 使 用 lock 对 设置 属性 g 的 代码 
进行 了 加 锁 。 


class AnimateHandler(Handler) : 
def init(self, info): 
info.object. start_animation() 
return True 


def closed(self, info, is_ok): 


info.object.end_animation() 


界面 的 显示 和 关闭 事件 需要 在 Handler 中 进行 处 理 ， 因 此 我 们 定义 了 一 个 AnimateHandler 
类 。 它 的 init0 将 在 界面 显示 之 前 被 调用 ， 而 closed0 则 在 界面 关闭 之 后 调用 。 这 两 个 方法 的 第 
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二 个 参数 info 是 一 个 UIInfo 对 象 ， 通 过 其 object 属性 可 以 获得 模型 对 象 。 


demo = VisualTraitsUI() 
demo.configure_traits(handler = AnimateHandler()) 


最 后 ,我 们 创建 一 个 VisualTraitsUI 对 象 demo， 并 调用 其 configure_traits0 显 示 界 面 ， 并 通 
过 handler 参数 传递 一 个 AnimateHandler 对 象 给 它 。 


11.5 创建 复杂 模型 


VPython 只 提供 了 一 些 简单 的 立体 几何 形状 ， 如 果 要 创建 复杂 的 物体 ， 就 需要 用 户 自 己 编 
写 程序 ， 计 算 物 体 的 多 边 形 网 格 模型 数据 ， 并 使 用 faces0 将 数据 转换 为 模型 进行 显示 。 

任何 一 个 三 维 模型 都 可 以 用 许多 三 角形 的 面 来 表示 ， 对 于 每 个 三 角形 的 每 个 顶点 ， 我 们 需 
要 计算 如 下 数据 : 

e 顶点 的 坐标 : 三 个 浮 点 数 表示 的 三 维 坐标 。 

e 顶点 的 法 线 方向 : 三 个 浮 点 数 表示 的 三 维 方向 矢量 。 

e 顶点 的 颜色 : 三 个 浮 点 数 表示 的 红 、 绿 、 蓝 颜色 分 量 。 

将 保存 上 述 数据 的 三 个 数组 传递 给 faces0 即 可 创建 三 维 模型 。 对 于 一 个 有 N 个 三 角形 的 模 
型 ， 每 个 数组 的 长 度 都 是 3*3*N， 也 可 以 传递 一 个 形状 为 (3*N,3) 的 二 维 数组 。 


11.5.1 faces() 的 用 法 


下 面 的 例子 演示 了 faces0 的 基本 用 法 ， 它 通过 手工 设置 顶点 坐标 、 法 线 方向 和 顶点 颜色 等 
数据 ， 绘 制 一 个 彩色 三 角形 。 


f vpython faces.py 


过 


全 于 使 用 faces0 绘 制 彩色 三 角形 


pos = np.array([ 
[8,8,8]，# 顶点 1 的 坐标 
[1,8,8]，# 顶点 2 的 坐标 
[8,1,8]，# 顶点 3 的 坐标 

]，dtype=np.float) 


normal = np.array([ 
[8,8,1]，# 顶点 1 的 法 线 方向 
[8@,8,1]，# 顶点 2 的 法 线 方向 
[8@,8,1]，# 顶点 3 的 法 线 方向 

]，dtype=np.float) 


color = np.array([ 
[8,8,1]，# 顶点 1 的 颜色 
[8,1,8]，# 顶点 2 的 颜色 
[1,8,8]，# 顶点 3 的 颜色 
], dtype=np.float) 


def single face(): 
faces(pos=pos, normal=normal, color=color) 


single face() 


程序 可 绘制 如 图 11-14 所 示 的 彩色 三 角形 ( 见 文 前 彩 插 ), 此 三 角形 各 个 顶点 的 数据 分 别 是 ; 
[ZX ox 


e 直角 顶点 的 坐标 为 (0.0.0), 颜色 为 蓝 色 (0,0,1)。 
e 右 方 顶点 的 坐标 为 (1,0.0), 颜色 为 绿色 (0,1.0)。 
e。 上方 顶点 的 坐标 为 (0.1.0), 颜色 为 红色 (1,0,0)。 
e 所 有 项 点 的 法 线 方向 都 是 Z 轴 正 方向 (0,0,1)。 
由 于 每 个 顶点 的 颜色 不 同 ， 因 此 三 角形 面 上 的 颜 
色 为 这 三 个 顶点 颜色 的 混合 。 如 果 旋 转 照相 机 查看 此 
彩色 三 角形 的 反面 ， 就 会 发 现 三 角形 竟然 消失 了 。 这 
是 因为 使 用 facesO 创 建 的 所 有 三 角形 都 是 单 面 三 角 
形 ， 单 面 三 角形 只 有 在 其 项 点 顺序 成 道 时 针 顺 序 时 才 
会 被 泻 染 显 色 。 上 面 的 例子 中 ， 从 Z 轴 上 方 观看 此 三 
角形 时 ， 其 三 个 顶点 的 顺序 为 逆 时 针 方 向 ， 而 从 Z 轴 
下 方 观看 时 ， 顶 点 的 顺序 就 变 成 了 顺 时针 方 向 。 
读者 可 以 对 调 顶点 1 和 项 点 2 的 坐标 试 试 ， 这 时 从 乙 轴 上 方 就 看 不 到 三 角形 了 。 
为 了 实现 无 论 从 哪个 方向 都 能 看 到 它 ， 我 们 需要 创建 另外 一 个 顶点 顺序 相反 的 三 角形 。 下 
面 的 程序 创建 双 面 三 角形 ， 这 里 用 pos[::-1] 得 到 一 组 顺序 完全 相反 的 坐标 数组 ， 然 后 用 vstackO 
将 两 个 二 维 数组 沿 着 垂直 方向 (第 0 轴 ) 又 起 来 ,形成 一 个 形状 为 (6,3) 的 数组 ,对 于 normal 和 color 
数组 也 进行 同样 的 处 理 : 


11-14 用 faces0 绘 制 的 彩色 三 角形 


def double face(pos, normal, color): 

triangle = frame() 

f = faces( 
pos=np.vstack([pos, pos[::-1]]), 
normal=np.vstack([normal, normal[::-1]]), 
color=np.vstack([color, color[::-1]]), 
frame=triangle) 

return triangle 


triangle = double face(pos, normal, color) 
triangle.pos = -1, -1, 0 
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在 上 面 这 段 程序 中 ,我 们 用 一 个 fame 对 象 对 face 对 象 进行 封装 , 这 样 便 可 以 通过 修改 fame 
对 象 的 pos 属性 来 改变 三 维 模型 的 位 置 。 


11.5.2” 读 入 模型 数据 


对 于 复杂 的 模型 ， 手 工 设置 或 计算 出 所 有 的 数据 是 很 困难 的 。 因 此 ，faces0 通 常用 于 显示 
从 三 维 数据 文件 中 读 入 的 三 维 模型 。 这 里 以 DirectX8 格式 为 例 , 说 明 如 何 读 取 数据 并 建造 复杂 
的 模型 。 

首先 看 一 下 DirectX8 的 模型 格式 ， 下 面 是 一 个 四 面体 模型 的 DirectX8 格式 的 文件 ， 这 里 
只 显示 程序 需要 读 入 的 部 分 : 


sh Cone.x 


* ”四 面体 模型 的 DirectX8 格式 的 文件 


四 面体 由 4 个 三 角形 面 构成 , 而 每 个 三 角形 都 有 三 个 顶点 , 因此 需要 保存 12 个 顶点 坐标 ”。 
下 面 是 “cone.x” 文 件 中 保存 顶点 坐标 信息 的 部 分 。 定 义 模型 的 每 个 面 时 ， 都 通过 顶点 序号 指 
定 构成 此 面 的 顶点。 例如 第 0 个 面 的 数据 为 “3; 0, 2, 1;,”， 这 表示 它 由 序号 为 0、2、1 的 三 个 
顶点 构成 ， 这 三 个 顶点 的 坐标 可 在 前 面 的 顶点 坐标 列表 中 寻找 : 


Mesh { 

12; // 顶点 数 

8.258866; -6.965966; -1.666666;， // 顶点 8 的 坐标 
0.707180; 8.767166; -1.996866;， // 顶点 1 的 坐标 
8.666666; 8.666666; 1.600880;， // 顶点 2 的 坐标 
8.666666; 6.666666; 1.966666; ， 

-6.965966; 8.258866; -1.696666j， 

0.258880; -6.965966; -1.668666j， 

8.666666; 9.666666; 1.966666; ， 

8.767166; 8.767166; -1.666866;， 

-6.965966; 6.258866; -1.666666j， 

6.767166; 6.767166; -1.966866;， 

6.258866; -6.965966; -1.666666; ， 

-8.965966; 6.258866; -1.000880;; 

4; // 面 数 

3; 6，2，1;，// 构成 第 8 面 的 顶点 序号 ，3 表示 此 面 由 三 个 顶点 构成 ，9、2、1 为 顶点 的 序号 
3 3 DA 

3; 6, 8, 7;, 
3; 9 11, 2033 


下 面 是 保存 材质 信息 的 部 分 。 四 面体 的 每 个 面 都 有 不 同 的 颜色 ， 因 此 一 共有 4 个 材质 ， 每 


图 四 面体 模型 虽然 只 有 4 个 项 点， 但 是 模型 文件 为 每 个 三 角形 都 单独 保存 顶点 坐标 


个 面 通过 材质 的 序号 指明 它 所 使 用 的 材质 : 


MeshMaterialList { 
4; // 材质 数 
4; // 材质 的 面 数 
2，// 第 8 面 的 材质 序号 
8，// 第 1 面 的 材质 序号 
1，// 第 2 面 的 材质 序号 
3;;// 第 3 面 的 材质 序号 
Material Material 862 { // 材质 @ 
9.882764; 8.162267; 8.867314;1.8;; // 材质 的 颜色 


} 
Material Material { // 材质 1 
9.156824; 8.737877; 6.816666;1.6;; // 材质 的 颜色 


} 
// 此 处 省 略 了 两 个 材质 
} 


最 后 是 保存 法 线 方向 矢量 的 部 分 ， 它 和 保存 坐标 的 方法 一 样 。 先 是 每 个 顶点 的 方向 矢量 列 
表 ， 如 果 读 者 做 一 下 计算 就 会 发 现 ， 所 有 方向 矢量 的 长 度 均 为 1。 然 后 是 每 个 面 的 顶点 序号 列 
表 ， 这 个 列表 和 点 的 坐标 部 分 的 列表 是 一 样 的 : 


1111111111111/ 每 个 面 的 法 线 方向 /AAAAAAAAAAAAA/ 
MeshNormals { 

12; // 顶点 的 法 线 方向 矢量 数 ， 和 项 点 数 相同 
8.228584; -8.853175; -9.468825; ，// 每 个 顶点 的 法 线 方向 矢量 
98.624561; 69.624561; -8.468825;， 

68.666666; 6.686686; 1.686686j ， 

8.666666; 8.666686; 1.986666j ， 

-8.853175; 8.228584; -0.468825;， 
0.228584; -8.853175; -0.468825;， 
8.666666; 8.986666; 1.986886j ， 

8.624561; 69.624561; -8.468825;, 
-0.853175; 8.228584; -9.468825; ， 
0.624561; 8.624561; -9.4688253; ， 
0.228584; -8.853175; -9.468825; ， 
-8.853175; 8.228584; -0.468825;; 

4; // 面 数 

3; 8，2，1;，// 面 上 每 个 顶点 的 法 线 方向 的 序号 

3 3, 5, 4;, 

3 .65 83 23 

1 
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} //End of MeshNormals 


从 上 面 的 例子 可 以 看 出 , 文件 中 正好 包括 了 我 们 需要 读 入 的 顶点 坐标 、 顶 点 颜色 和 项 点 法 


线 方向 三 个 部 分 。 在 了 解 三 维 模型 的 文件 格式 之 后 ， 我 们 很 容易 写 出 如 下 程序 ， 进 而 读 入 文件 


二 


与 模型 相关 的 数据 ， 并 通过 faces0 将 其 显示 在 VPython 的 场景 中 : 


更 vpython xmodelpy 
将 DirectX8 格式 的 文件 转 为 Visual 库 的 模型 


import numpy as np 
from visual import * 


def search line_startswith(f, pattern): 


while True: 
line = f.readline() 
if line == "": return False 


if line.strip().startswith(pattern): 
return True 


def read directx model(filename, double=False): 
f = open(filename) 
search_line_startswith(f,，"Mesh") # 定位 Mesh 行 


point_num = int(f.readline().split(";")[8]) # 读 入 顶点 数 
points = np.zeros((point_num，3)) # 初始 化 保存 顶点 坐标 的 数组 
# 读 入 所 有 项 点 坐标 
for i in xrange(point_num): 
points[i, :] = [float(x) for x in f.readline().split(";")[:3]] 


face_num = int(f.readline().split(";")[8]) # 读 入 面 数 


# 初始 化 三 角形 的 项 点 坐标 数组 
pfaces = zeros( (face_num*3 ，3)) # 正面 的 项 点 下 标 


# 创建 所 有 的 模型 面 的 项 点 坐标 数组 ， 将 面 的 项 点 下 标 蔡 换 为 顶点 坐标 
cnt = 9 
for i in xrange(face_num) : 
p_index = [int(x) for x in f.readline().split(";")[1].split(",")] 
for j in xrange(3): 
pfaces[cnt, :] = points[p_index[j], :] 
cnt += 1 


search_line_startswith(f，"MeshMaterialList") # 定位 材质 
color_num = int(f.readline().split(";")[8]) # 读 入 材质 数 
face_color_num = int(f.readline().split(";")[8]) # 读 出 面 数 


# 读 入 每 个 面 的 材质 下 标 


face_color_ list=[] 
for i in xrange(face_color_num): 
face_color_ list.append( int(f.readline().strip(",;\n")) ) 


colors = np.zeros((color_num，3)) # 初始 化 存储 材质 颜色 的 数组 
# 读 入 所 有 材质 的 颜色 
for i in xrange(color_num): 
search_line_startswith(f, "Material") 
colors[i,:] = [float(x) for x in f.readline().split(";")[:3]] 


# 初始 化 保存 每 个 顶点 颜色 的 数组 


pcolors = np.zeros( (face_color_num*3，3)，np.float) 


# 创建 顶点 颜色 数组 ， 将 面 的 材质 下 标 蔡 换 为 顶点 的 材质 颜色 
cnt = 9 
for i in xrange(face_color_num): 
color_idx = face_color list[i] 
for j in xrange(3): 
pcolors[cnt, :] = colors[color idx,:] 
cnt += 1 


search_line_startswith(f,，"MeshNormals") # 定位 法 线 方向 


# 读 入 法 线 方向 
point num = int(f.readline().split(";")[8]) 
npoints = np.zeros((point_num, 3)) 
for i in xrange(point_num): 
npoints[i,:] = [float(x) for x in f.readline().split(";")[:3]] 


face_num = int(f.readline().split(";")[8]) # 读 入 面 数 
# 初始 化 项 点 法 线 方向 数组 


nfaces = np.zeros( (face num*3 , 3), np.float) 


# 创建 项 点 法 线 方向 数组 ， 将 每 个 面 的 法 线 下 标 蔡 换 为 实际 的 法 线 方向 
cnt = 9 
for i in xrange(face_num) : 
p_index = [int(x) for x in f.readline().split(";")[1].split(",")] 
for j in xrange(3): 
nfaces[cnt, :] = npoints[p_index[j],:] 
cnt += 1 


f.close() 


if double: 
pfaces = np.vstack((pfaces, pfaces[::-1])) 
nfaces = np.vstack((nfaces, nfaces[::-1])) 
pcolors = np.vstack((pcolors, pcolors[::-1])) 


| 洲 08 人 答 盐 一 uoUHAd 信 


y 


团 避 


| 浒 q8 庆 得 一 uodAdA 


加 时 


Python 科学 计算 


if _name == 


model frame = frame() 

# 使 用 项 点 坐标 数组 ， 顶 点 颜色 数组 和 顶点 法 线 方向 数组 构造 模型 

model = faces( pos = pfaces, normal = nfaces, color = pcolors, frame = model frame ) 
return model frame 


_main 
import sys 
scene.background = (8.9, 68.9, 8.9) 
scene.title = sys.argv[1] 

read directx model(sys.argv[1], True) 


上 面 程序 中 , 为 了 方便 操作 所 创建 的 CE .0 


模型 ,我 们 用 一 个 frame 对 象 将 faces 对 象 
封装 起 来 。 如 果 double 参数 为 True, 就 使 
用 上 一 节 介 绍 的 方法 将 所 有 的 数据 反 转 
并 添加 到 原始 数据 的 后 面 ， 这 样 一 来 ， 所 
有 的 三 角形 就 都 是 双 面 的 ， 能 够 从 任何 方 
向 看 到 它们 。 使 用 “vpython_xmodelpy” 

显示 “cone.x” 模 型 文件 的 效果 如 图 11-15 


所 示 。 
我 们 当然 不 会 手工 创建 如 此 复杂 的 ”图 11-15 在 Visual 中 显示 DirectX8 格式 的 四 面体 模型 


模型 数据 文件 。 开 源 三 维 设计 软件 Blender 支持 数 十 种 不 同 格式 的 模型 文件 的 输入 输出 ， 其 中 
就 包括 DirectX8 格式 。 因 此 可 以 利用 Blender 的 强大 功能 ， 转 换 或 制作 复杂 的 三 维 模型 ， 最 后 
用 faces 对 象 将 其 显示 在 动画 场景 中 。 图 11-16 显示 了 Blender 设计 汽车 模型 ?时 的 界面 及 其 在 


VPython 场景 中 的 显示 效果 。 


图 11-16 使 用 Blender 设计 汽车 模型 ， 在 VPython 中 显示 转换 后 的 模型 


回 此 汽车 模型 来 源 于 互联 网 。 


开源 三 维 设计 软件 Blender 

Blender 是 一 个 多 平台 的 开源 三 维 绘图 和 泻 染 软件 。 它 提供 了 非常 多 的 工具 ， 其 用 户 界 
面 对 初学 者 来 说 比较 复杂 , 但 花 些 时 间 阅 读 说 明文 档 应 该 能 掌握 其 基本 用 法 。 它 采用 Python 
作为 脚本 语言 进行 二 次 开发 ， 因 此 喜欢 Python 的 读者 一 定 要 下 载 尝试 一 下 。Blender 的 
Windows 安装 版 已 经 收录 在 本 书 所 附 的 光盘 中 。 


> http://www.blender.org 
使 用 Python 作为 脚本 语言 的 开源 3D 设计 软件 Blender 的 官方 地 址 


下 面 是 汽车 模型 动画 的 演示 程序 。 


vpython carpy 
二 。 读 取 Blender 输出 的 汽车 模型 ， 制 作 汽车 模拟 动画 


此 程序 除了 读 入 并 显示 汽车 模型 之 外 ， 还 制作 了 不 断 重 复 移动 的 地 面 和 车 轮 的 滚动 效果 ， 
看 上 去 就 像 汽车 在 地 面 上 飞驰 一 样 。 而 且 可 以 通过 按键 @' 和 's 控 制 汽车 的 方向 ?"， 通 过 按键 x 和 
改变 汽车 轮胎 的 方向 ?。 由 于 车 胎 需 要 同时 围绕 其 X 轴 和 Z 轴 旋转 以 达到 滚动 和 方向 转动 的 
效果 ， 因 此 车 胎 的 旋转 计算 稍微 有 些 复杂 ， 请 读者 自行 根据 程序 中 的 注释 进行 研究 。 


汽车 实际 上 是 不 动 的 ， 程 序 改变 的 是 地 面 的 移动 方向 。 
@ 轮胎 方向 和 汽车 的 转弯 并 不 同步 ， 实 际 上 本 程序 运用 于 某 车 胎 实验 系统 ， 这 些 参数 都 是 直接 从 模拟 器 获得 的 。 
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OpenCV 最 初 是 由 英特尔 公司 开发 的 一 套 开源 的 跨 平台 计算 机 视觉 库 。 它 用 C 语言 实现 了 
许多 图 像 处 理 和 计算 机 视觉 领域 的 算法 ， 并 提供 了 C++ 的 调用 接口 。 虽 然 本 书 只 介绍 如 何在 
Python 中 使 用 OpenCV， 但 是 为 了 更 深入 地 了 解 其 内 部 构成 ， 推 荐 读者 下 载 官方 的 OpenCYV 安 
装 包 ， 其 中 还 包括 了 PDF 文档 和 OpenCV 的 源 程序 。 


» http://opencv.willowgarage.com 
OpenCV 的 官方 网 址 


OpenCV 的 Python 调用 接口 模块 有 如 下 几 种 : 
e 旧版 本 的 OpenCV 通过 SWIG 提供 了 Python 的 接口 模块 ， 最 上 层 的 模块 可 以 通过 
“import opencv” 载 入 。 
e ”OpenCV 2.1 之 后 的 版 本 则 提供 了 一 套 全 新 的 Python 接口 模块 , 可 以 通过 “import cv” 
载 入 。 
e 通过 ctypes 制作 的 接口 模块 载 入 “import ctypes_opencv”。 
e 通过 BoostPython 制作 的 接口 模块 载 入 “importpyopencv”。 
前 两 套 接口 模块 由 OpenCV 官方 提供 ， 而 后 两 套 为 第 三 方 开 发 。 使 用 BoostPython 制作 的 
PyOpenCV 的 API 和 C++ API 十 分 相似 ， 并 且 它 能 很 好 地 兼容 NumPy 数组 。 


» http://code.google.com/p/pyopencv/ 
PyOpenCV 项 目的 地 址 


本 书 只 介绍 PyOpenCV 的 使 用 方法 。 虽 然 没有 详细 的 说 明文 档 ， 但 参照 OpenCV 的 官方 
C++ 文 档 ， 可 以 很 快 了 解 PyOpenCV 的 用 法 。 


为 了 演示 PyOpenCV 中 各 种 函数 的 图 像 处 理 效果 , 本 章 使 用 TraitsUI 制作 了 许多 交互 
世 。 式 演示 程序 ， 它 们 的 文件 名 均 以 ”demopy” 结 尾 。 为 了 保证 这 些 演示 程序 能 够 正常 
运行 ， 请 确认 系统 中 正确 安装 了 Traits 库 。 


本 章 演示 程序 使 用 的 版 本 为 “PyOpenCV 1.2.0”， 需 要 将 Numpy 升级 到 1.4.1 版 本 以 
上 才能 正常 使 用 它 。 


12.1 存储 图 像 数 据 的 Mat 对 象 


为 了 避免 命名 冲突 ， 本 书 使 用 如 下 方式 载 入 pyopencv 模块 : 
import pyopencv as cv 


让 我 们 从 读 入 并 显示 一 幅 图 像 开始 ， 在 IPython 中 运行 如 下 语句 ， 将 会 看 到 一 个 显示 美女 
“lena” 的 窗口 。 


a a show_img.py 
用 OpenCV 显示 一 幅 图 像 


>>> img = cv.imread("lena.jpg") 
>>> cv.namedWindow("demo1") 
>>> cv.imshow("demo1", img) 


首先 ，imreadO 〇 从 指定 的 文件 路 径 读 入 图 像 数 据 ， 它 支持 许多 常用 的 图 像 格 式 ， 在 不 同 的 
操作 系统 下 它 所 支持 的 图 像 格式 可 能 有 所 不 同 。 请 读者 阅读 C++ 文档 以 了 解 imread0 的 详细 信 
息 。 此 外 ，OpenCV 还 提供 了 imwrite0， 用 于 将 图 像 数据 写 入 文件 。 


如 果 不 是 在 交互 式 环境 下 运行 上 面 的 程序 , 就 需 在 程序 最 后 添加 “cv.waitKey(0)”, 否 
证 则 图 像 窗口 在 显示 之 后 将 立即 关闭 ,结束 程序 运行 。 这 里 ，waitKey0 表 示 等 待 用户 按 
下 按键 ， 其 参数 为 等 待 的 毫秒 数 ，0 表示 永远 等 待 。 

为 了 方便 用 户 快速 观察 图 像 处 理 的 效果 , OpenCV 提供 了 一 些 简 单 的 GUI 功能 。 这 里 调用 
namedWindowO， 创 建 一 个 名 为 “demol” 的 窗口 ， 最 后 调用 imshow0 将 图 像 显 示 到 所 创建 的 
窗口 中 。imshow0 的 第 一 个 参数 是 窗口 名 ， 第 二 个 参数 是 表示 图 像 的 Mat 对 象 。 实 际 上 ， 如 果 
第 一 个 参数 所 指定 的 窗口 不 存在 ，imshow0 会 自动 创建 一 个 新 窗口 ， 因 此 这 里 可 以 省 略 对 
namedWindow0 的 调用 。 

在 OpenCV 中 ，Mat 对 象 表示 图 像 ， 它 是 整个 系统 的 核心 ， 几 乎 所 有 的 函数 都 和 它 相关 。 
下 面 我 们 从 它 的 基本 属性 开始 逐步 学 习 : 


>>> type(img) 

<class “pyopencv.cxcore_hpp_point_ext.Mat > 
>>> img.size() 
Size2i(width=512，height=393) 

>>> img.channels() 

3 

>>> img.depth() 
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>>> img.type() 
16 


Mat 对 象 提供 了 size0、channels0 和 depth0 等 方法 ， 可 分 别 获得 图 像 的 大 小 、 通 道 数 和 数 
值 类 型 。 上 面 的 例子 中 ， 图像 img 的 宽 为 512 个 像素 ， 高 为 393 个 像素 ， 有 3 个 通道 (channel)， 
即 图 像 中 每 个 像素 的 颜色 用 三 个 数值 表示 。 每 个 通道 的 数值 类 型 (depth) 的 编号 为 0，0 表示 无 
符号 8 位 整数 。 另 外 还 有 type0 方 法 ， 可 以 获得 一 个 同时 表示 通道 数 和 数值 类 型 的 编号 ， 我 们 
可 以 将 它 理 解 为 像素 类 型 。 关 于 这 方面 的 内 容 将 在 12.2 节 详细 介绍 。 

Mat 对 象 有 许多 属性 和 方法 ， 请 读者 使 用 IPython 的 自动 完成 功能 来 查看 img 对 象 的 属性 
和 方法 ， 并 和 C++ 文档 的 说 明 进 行 比较 。 例 如 ， 我 们 可 以 找到 一 个 row0 方 法 ， 它 获得 图 像 的 
指定 行 ， 返 回 一 个 新 的 Mat 对 象 ， 但 是 它 和 原 图 像 共享 图 像 数 据 ， 这 一 点 和 NumPy 的 数组 视 
图 很 相似 : 


>>> type(img.row(16)) 

<class “pyopencv.cxcore_hpp_point_ext.Mat "> 
>>> img.row(16).size() 
Size2i(width=512，height=1) 


12.1.1 Mat 对 象 和 NumPy 数组 


Mat 对 象 本 身 提 供 的 众多 属性 和 方法 并 不 符合 Python 的 风格 ， 因 此 PyOpenCV 对 Mat 类 
进行 了 扩展 ， 使 得 它 能 像 NumPy 的 数组 一 样 使 用 。 下 面 的 语句 用 “img[:]” 从 Mat 对 象 mg 
创建 一 个 表示 整个 图 像 的 数组 ， 并 查看 数组 的 shape 和 strides 属性 : 


>>> img[:].shape 
(393，512，3) 
>>> img[:].strides 
(1536, 3, 1) 


请 注意 Mat 对 象 本 身 并 不 是 数组 ， 因 此 它 没有 shape 属性 : 


>>> img.shape 
AttributeError: “Mat” object has no attribute “shape" 


仔细 观察 数组 的 shape 属性 ， 可 以 发 现 数组 的 第 0 轴 的 长 度 为 图 像 的 高 度 ， 第 1 轴 的 长 度 
为 图 像 的 宽度 ， 而 第 2 轴 的 长 度 为 图 像 的 通道 数 。 由 strides 属性 的 值 可 知 ， 每 个 通道 的 数据 占 
用 1 个 字 节 ， 而 一 个 像素 点 占用 3 个 字 节 ， 一 行 数 据 占 用 512*3=1536 个 字 节 。 因 此 ， 图 像 数 
据 在 内 存 中 是 连续 存储 的 。 

下 面 的 语句 获得 图 像 的 第 1 行 到 第 3 行 、 第 5 列 到 第 9 列 、 第 0 通道 的 数据 ， 所 得 到 的 数 
组 a 和 Mat 对 象 共享 图 像 数 据 : 


>>> a = img[1:4,5:16,6] 
>>> a.strides # 由 于 a 和 img 共享 图 像 数据 ， 因 此 第 8 轴 的 stride 仍然 是 1536 个 字 节 
(1536, 3) 
>>> a 
array([[199，168，167，169，167]， 
[168，167，166，116，167]， 
[166，166，166，113，168]]，dtype=uint8) 


修改 a[0,0] 将 同时 修改 img[1.5.0]， 它 们 在 内 存 中 的 地 址 是 相同 的 : 


>>> a[8,8] = 268 # a 和 img 共享 图 像 数 据 
>>> img[1,5,6] 
266 


使 用 下 标语 法 也 可 以 直接 设置 Mat 对 象 中 的 数据 。 例如， 下 面 将 第 0 和 第 1 通道 的 数据 都 
设置 为 0: 
>>> img[:,:,6] = 9 


>>> img[:,:,1] = 9 
>>> cv.imshow("demo1", img) 


由 于 在 使 用 imread0 读 入 的 Mat 对 象 中 ， 三 个 通道 分 别 与 蓝 、 绿 、 红 三 个 颜色 相对 应 ， 上 
面 的 语句 将 蓝 、 绿 通道 的 数值 都 设置 为 0， 因 此 将 显示 一 幅 全 是 红色 的 图 像 。 


实际 上 ,在 OpenCV 内 部 每 个 通道 并 没有 固定 对 应 某 种 颜色 ， 只 是 在 用 imshow0、 
可 imreadO 和 imwrite0 等 函数 时 ， 才 将 通道 按照 蓝 、 绿 、 红 的 顺序 进行 输入 和 输出 。 


我 们 也 可 以 使 用 matplotlib 的 imshow0 绘 制图 像 ， 但 是 由 于 它 要 求 图 像 的 三 个 通道 的 存储 
顺序 为 红 、 绿 、 蓝 ， 因 此 需要 将 图 像 的 第 2 轴 反 向 : 


>>> img = cv.imread("lena.jpg") 

>>> import pylab as pl 

>>> pl.imshow(img[:,:,::-1]) # 将 第 2 轴 反 向 
>>> pl.show() 


另外 ， 使 用 Mat 对 象 的 ndarray 属性 也 可 以 获得 数组 : 


>>> img.ndarray.shape 
(393, 512, 3) 


Mat.ndarray 实际 上 是 一 个 Property 属性 , 每 次 读 取 它 时 都 会 调用 某 个 函数 得 到 一 个 新 的 数 
组 。 下 面 通过 id0 查 看 imgndarray 的 内 存 地 址 ， 两 次 结果 不 相同 ， 这 表示 它们 是 不 同 的 数组 。 
但 是 请 注意 ， 这 两 个 数组 的 数据 存储 区 是 相同 的 ， 都 和 原始 的 Mat 对 象 img 共享 图 像 数据 : 
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>>> img._class__.ndarray 
<property object at 8@x81C47AEQ> 
>>> id(img.ndarray) 

49696488 

>>> id(img.ndarray) # 两 次 通过 ndarray 获得 的 数组 不 是 同一 个 数组 
49778224 


也 可 以 使 用 asMat0 函 数 从 数组 创建 Mat 对 象 ， 这 样 我 们 就 能 用 OpenCV 的 图 像 处 理 功能 
对 NumpPy 数组 进行 处 理 。 下 面 的 程序 演示 了 这 一 过 程 ， 运 行 效果 如 图 12-1 所 示 ( 见 文 前 彩 插 )。 


A opencv_numpy2mat.py 
宫 志 将 数组 转换 为 Mat 对象 并 进行 图 像 处 理 


import pyopencv as cv 
import numpy as np 


y, x = np.ogrid[-1:1:256j,-1:1:256j] 
z= np.sin(16*np.sqrt(x*x+y*y))*0.5 + 9.5 © 
np.round(z, decimals=1, out=z) ©@ 


img = cv.asMat(z) © 


cv.namedWindow("demo1") 
cv.imshow("demo1", img) 


img2 = cv.Mat() @ 
cv.Laplacian(img, img2, img.depth(), ksize=3) © 
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cv.namedWindow("demo2") 
cv.imshow("demo2", img2) 
cv.waitKey(0) 


er 


图 12-1 使 用 Laplacian 算 子 对 从 NumPy 产生 的 图 像 进行 边缘 检测 
@ 首 先 , 数组 z 是 一 元 函数 Jsinl0Va + ) + 在 (1,-D) 到 (LD 网 格 上 的 计算 结果 ， 它 的 
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取 值 范围 是 0 到 1。@ 为 了 使 后 续 的 图 像 处 理 函数 能 够 正常 工作 ， 这 里 对 数组 z 中 的 数值 保留 
小 数 点 后 一 位 的 精度 。@ 使 用 asMat0 将 数组 z 转换 为 图 像 mg， 图 像 img 将 和 数组 z 共享 图 像 
数据 ， 读 者 可 以 自行 验证 。 

@ 为 了 进行 图 像 处 理 ， 先 创建 一 个 空 图 像 img2， 当 将 空 图 像 传递 给 某 个 OpenCV 的 图 像 
处 理 函数 时 ，OpenCYV 会 自动 为 其 分 配 内 存 以 保存 结果 。 如 果 img2 不 是 空 图 像 ， 并 且 它 的 大 
小 、 通 道 数 和 数值 类 型 都 满足 图 像 处 理 函数 的 输出 要 求 ， 将 不 会 分 配额 外 的 内 存 ， 而 是 直接 把 
结果 保存 到 它 的 图 像 数 据 区 。@ 调 用 Laplacian0 对 img 进行 边缘 检测 ， 并 将 结果 保存 到 img2 
中 。 在 本 例 中 ， 图 像 的 像素 类 型 为 单 通道 的 双 精度 浮 点 数 ， 因 此 它 是 一 幅 灰 度 图 ， 其 中 0 表示 
黑色 ，1 表示 白色 。 

在 使 用 asMatO 进 行 转换 时 ， 它 会 首先 尝试 将 数组 的 最 后 一 个 轴 转 换 为 图 像 的 通道 ， 因 此 
用 下 面 的 语句 无 法 将 一 个 4*3 的 二 维 数组 转换 为 单 通道 的 4*3 的 Mat 对 象 : 


>>> a = np.zeros((4,3)) 
>>> b = cv.asMat(a) 


转换 后 的 结果 是 一 个 1*4 的 三 通道 Mat 对 象 : 


>>> b.size() 
Size2i(width=4, height=1) 
>>> b.channels() 

过 


如 果 设 置 asMat0 的 force_single_channel 参数 为 Tme， 将 强制 产生 单 通道 的 Mat 对 象 : 


>>> cv.asMat(a,force_single_channel=True).size() 
Size2i(width=3, height=4) 


除了 Mat 对 象 之 外 , OpenCV 还 提供 了 MatND 对 象 来 表示 多 维 数组 。 下面 调 用 asMatNDO 
将 三 维 数组 转换 成 MatND 对 象 ， 并 通过 dims 属性 查看 其 维 数 : 


>>> c = cv.asMatND(np.zeros((16,26,36))) 
>>> c.dims 


MatND 对 象 使 用 size 和 step 属性 保存 每 个 轴 的 长 度 和 字 节 偏 移 量 , 它们 和 NumPy 数组 的 
shape 和 strides 属性 类 似 。 但 是 这 两 个 属性 都 是 长 度 固定 为 32 的 整数 数组 。 因 此 我 们 需要 使 用 
dims 属性 获取 其 中 所 需 的 部 分 : 


>>> c.size # 得 到 一 个 长 度 固定 为 32 的 整数 数组 
<pyopencv.cxcore_h ext._ array_1 int 32 object at 8x64A4C688> 


这 个 数组 对 象 可 以 使 用 正 整 数 下 标 获取 其 中 的 元 素 , 或 者 使 用 len0 获 取 其 长 度 ， 除 此 之 外 
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没有 提供 其 他 的 元 素 存 取 方 法 。 因 此 为 了 访问 方便 ， 我 们 可 以 调用 list0 将 其 转换 为 列表 : 


>>> list(c.size) 

上 02030079 0B, 99 350] 
>>> list(c.size)[:c.dims] 
[10, 20, 38] 

>>> list(c.step)[:c.dims] 
[4886，246，8] 


和 Mat 对 象 一 样 ，MatND 对 象 也 可 以 很 方便 地 转换 为 数组 : 


>>> c[:].shape 
(10, 20, 30) 
>>> c[:].strides 
(48886，246，8) 
>>> c[:].dtype 
dtype( "float64' ) 


12.1.2 ”像素 点 类 型 


图 像 中 的 每 个 像素 点 可 能 有 多 个 通道 。 例如， 用 单 通 道 可 以 表示 灰 度 图 像 ， 用 红 、 绿 、 蓝 
3 个 通道 "可 以 表示 彩色 图 像 ， 用 4 个 通道 可 以 表示 带 透明 度 (alpha) 的 彩色 图 像 。 每 个 通道 的 值 
可 以 是 不 同 的 数值 类 型 。 例 如 ， 通 常 的 图 像 用 8 位 无 符号 整数 表示 ， 而 医学 图 像 可 能 会 用 16 位 
整数 表示 。 因 此 ， 像 素 点 的 类 型 由 通道 数 和 通道 中 每 个 数值 的 类 型 决定 。 

用 Mat 对 象 的 type0 方 法 可 以 获得 图 像 的 像素 点 的 类 型 , 用 channels0 方 法 可 以 获得 像素 点 
的 通道 数 ， 用 depth0 方 法 可 以 获得 表示 通道 数据 的 数值 类 型 。typeO 和 depth0 返 回 的 都 是 一 个 
整数 序号 ， 每 个 整数 表示 的 类 型 都 在 OpenCV 的 头 文件 “cxtypesh” 中 使 用 “#define” 定 义 。 
下 面 截 取 其 中 的 一 部 分 : 


#define CV 8U 8 

#define CV 8S 1 

#define CV 16U 2 

#define CV_16S 3 

// .省略 ..-。 

#define CV_8UC1 CV_MAKETYPE(CV_8U,1) 
#define CV_8UC2 CV_MAKETYPE(CV_8U,2) 
#define CV_8UC3 CV_MAKETYPE(CV_8U,3) 


在 PyOpenCV 中 ， 可 以 通过 模块 中 的 全 局 变量 获得 这 些 常数 值 。 数 值 类 型 名 由 3 个 部 分 组 成 : 
e 固定 部 分 : “CV_”。 


@ 3 个 通道 的 图 像 不 一 定 是 存储 RGB( 红 绿 蓝 )3 种 颜色 的 数据 ， 也 可 以 是 HSV( 色 相 、 饱 和 度 和 明度 ) 等 其 他 表示 颜色 的 数据 。 


e 数值 的 比特 数 : 8、16、32、64。 

。 ”一 个 描述 类 型 的 字母 : “U” 表 示 无 符号 整数 、“S” 表 示 符 号 整数 、“F” 表 示 浮 点 数 。 

像素 类 型 则 在 数值 类 型 的 基础 上 ， 添 加 “C1”、“C2”、“C3”、“C4” 等， 分 别 表示 1 
到 4 个 通道 的 像素 类 型 。 因 此 ，“CV_16U” 表 示 16 位 的 无 符号 整数 ， 而 “CV_8UC3” 表 示 3 
个 通道 的 8 位 无 符号 整数 : 


>>> cv.CV_16U 
>>> cv.CV_8UC3 
16 


下 面 创建 一 个 宽 10 像素 、 高 20 像素 的 图 像 , 每 个 像素 点 都 是 3 个 通道 的 无 符号 8 位 整数 ， 
因此 将 其 转换 为 NumPy 数组 将 得 到 一 个 三 维 数组 ， 其 形状 为 20,10.3)， 并 且 数 值 类 型 为 uint8。 
当 图 像 只 有 一 个 通道 时 ， 数 组 为 二 维 数组 。 

>>> m = cv.Mat(cv.Size(19,29)，cv.CV_8UC3) 
>>> m[:].shape 

(20, 10, 3) 

>>> m[:].dtype 

dtype('uint8') 


12.1.3 ”其 他 数据 类 型 


在 OpenCV 中 , 使 用 C++ 的 泛 型 模板 定义 各 种 数据 类 型 , 每 种 类 型 的 模板 都 可 以 根据 一 些 
模板 参数 创建 多 种 实际 的 数据 类 型 。 因 为 模板 创建 的 类 型 需要 经 过 C++ 编译 之 后 才能 使 用 ， 所 
以 在 PyOpenCV 中 我 们 无 法 直接 使 用 这 些 泛 型 模板 。 为 了 解决 这 个 问题 , PyOpenCV 对 各 种 模 
板 创建 的 实际 数据 类 型 进行 了 封装 ， 下 面 我 们 具体 看 看 这 些 数据 类 型 。 

Point 类 型 表示 二 维 或 三 维 空间 中 点 的 坐标 ， 坐 标 值 可 以 是 整数 、 单 精度 浮 点 数 或 双 精 度 
浮 点 数 , 因此 一 共有 6 种 Point 类 型 。 下 面 我 们 用 IPython 的 自动 补 全 功能 显示 这 些 Point 类 型 : 


>>> cv.Point # 按 Tab 键 进行 自动 补 全 
cv.Point cv.Point2d cv.Point2f cv.Point2i cv.Point3d cv.Point3f cv.Point3i 


这 里 , cv Point 是 cv.Point2i 的 别名 ， 后 缀 “2i” 表 示 它 是 二 维 的 ， 并 且 坐 标 值 使 用 32 位 整 
数 表 示 。 此 外 , “3 ”表示 三 维 , “f” 表 示 单 精度 浮 点 数 , “d” 表 示 双 精度 浮 点 数 。 
在 了 Python 下 输入 “cv.Point2i?”， 可 以 看 到 init 0 支持 的 各 种 参数 : 


>>> cv.Point2i? 
init_( (object)arg1, (object) x, (object) y) -> None : 


C++ signature : 
void _ init_(_object*,int,int) 
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根据 上 面 显 示 的 参数 类 型 ， 我 们 可 以 用 两 个 整数 创建 Point2i 对 象 : 


>>> cv.Point2i(3, 4) 
Point2i(x=3, y=4) 


PyOpenCV 的 类 型 检测 十 分 严格 ， 如 果 使 用 类 型 不 兼容 的 值 就 会 出 错 ， 例 如 下 面 用 浮 点 数 
作为 参数 就 会 抛 出 ArgumentError 异常 : 


>>> cv.Point2i(3.6，4.6) 
ArgumentError ... 


甚至 使 用 NumPy 库 中 的 数值 类 型 也 会 出 错 ， 这 一 点 要 特别 注意 : 


>>> 七 = np.array([3,4]) 

>>> type(t[8]) # 由 于 t[8] 是 Numpy 中 的 一 个 int32 类 型 的 整数 
<type ‘numpy.int32'> 

>>> cv.Point2i(t[6]，t[1]) # 因此 用 t[8] 作 为 参数 会 出 现 类 型 错误 


ArgumentError ... 
需要 对 数组 元 素 进行 类 型 转换 ， 才 能 使 用 它 的 值 来 创建 Point2i 对 象 ; 


>>> cv.Point2i(int(t[6])，int(t[1])) 
Point2i(x=3，y=4) 

>>> cv.Point2i(*t.tolist()) 
Point2i(x=3, y=4) 


在 后 面 的 实例 程序 中 , 我 们 经 常 需要 用 数组 中 的 结果 创建 PyOpenCV 中 的 对 象 , 这 时 要 特 
别 注意 类 型 转换 问题 。 

和 Mat 对 象 一 样 ，Point 对 象 可 以 和 数组 相互 转换 。 使 用 asPoint*0 可 以 将 数组 转换 成 对 应 
类 型 的 Point 对 象 : 


>>> p = cv.asPoint3f(np.array([1,2,3],dtype=np.float32)) # 将 数组 转换 成 Point 对 象 
>>> p 

Point3f(x=1.0, y=2.0, z=3.0) 

>>> p[:].dtype # 通过 [:] 下 标 获得 NumPy 数组 

dtype( "float32 ) 

>>> p[:] = 196，26，36 # 获得 的 NumPy 数组 是 视图 

>>> p 

Point3f(x=10.0, y=20.0, z=30.0) 


Size 类 型 表示 二 维 空间 上 的 大 小 ， 一 共有 两 种 Size 类 型 : Size2i 和 Size2f。 用 asSize2i0 和 
asSize2f0 可 以 将 数组 转换 为 相应 的 Size 类 型 。 它 们 的 用 法 和 Point 类 型 相同 ， 请 读者 自行 在 


IPython 下 测试 。 

Rect 类 型 表示 二 维 空间 上 的 矩形 ， 它 只 支持 整数 类 型 。 

Vec 类 型 可 以 用 来 表示 较 短 的 一 维 数值 数组 。 根据 数组 的 长 度 和 数值 类 型 , 它 有 多 种 版 本 ， 
它们 都 有 对 应 的 函数 从 数组 进行 转换 。 


>>> cv.Vec # 按 Tab 键 自动 补 全 

Cv.Vec2b cv.Vec2i cv.Vec3b cv.Vec3i cv.Vec4b cv.Vec4i cv.Vec6d 
Cv.Vec2d cv.Vec2s cv.Vec3d cv.Vec3s cv.Vec4d cv.Vec4s cv.Vecef 
Cv.Vec2f cv.Vec2w cv.Vec3f cv.Vec3w cv.Vec4f cv.Vec4w 


后 级 中 的 数字 表示 所 创建 的 数组 的 长 度 , 最 后 的 字符 则 表示 数据 类 型 ,除了 前 面 介绍 的 “i”、 
“f” 和 “d” 之 外 ,“b” 表 示 8 位 无 符号 整数 ,“s” 表 示 16 位 符号 整数 ,“w” 表 示 16 位 无 符 
号 整数 。 


12.1.4 ”Vector 类 型 


在 C++ 中 ，Vector 是 可 动态 分 配 内 存 的 一 维 数组 模板 ， 用 它 可 以 创建 各 种 不 同 元 素 类 型 的 
动态 数组 类 型 -PyOpenCV 对 OpenCV 中 用 到 的 所 有 Vector 模板 创建 的 数组 类 型 都 进行 了 封装 ; 


>>> cv.vector_ # 按 Tab 键 自动 补 全 


[[ 省 略 ]] 

Cv.vector Point2i cv.vector_int 
cv.vector_Point3d Cv.vector_int16 
Cv.vector Point3f Cv.vector_int64 
Cv.vector Point3i cv.vector_int8 
cv.vector_Ptr_Mat cv.vector_long 
[[ 省 略 ]] 


这 些 类 型 中 的 大 部 分 都 可 以 通过 asvector_*0 函 数 将 数组 转换 成 对 应 的 类 型 对 象 : 


>>> cv.asvector_ # 按 Tab 键 自动 补 全 


[[ 省 略 ]] 

Cv.asvector_Point2i Cv.asvector Vec6f 
cv.asvector_Point3d cv.asvector_float32 
[[ 省 略 ]] 


下 面 我 们 通过 一 个 例子 来 学 习 Vector 类 型 的 用 法 。 
用 vector Pointpi 对 象 可 以 表示 二 维 平面 上 的 一 组 点 ,可 以 用 asvector Point2i0 将 一 个 shape 
为 (N,2) 的 整数 数组 转换 为 vector Point2i 对 象 : 
>>> a = np.arange(6).reshape(-1,2) 


>>> p = cv.asvector Point2i(a) 
>>> p 
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vector_Point2i(len=3, [Point2i(x=8, y=1), Point2i(x=2, y=3), Point2i(x=4, y=5)]) 
Vector 对 象 的 用 法 和 列表 类 似 ， 可 以 使 用 切片 下 标 或 者 动态 地 改变 其 大 小 : 


>>> p[:2] 

vector_Point2i(len=2, [Point2i(x=8, y=1), Point2i(x=2, y=3)]) 

>>> del p[-1] 

>>> p.append( cv.Point2i(16,16) ) 
vector_Point2i(len=3，[Point2i(x=8，y=1)，Point2i(x=2，y=3)，Point2i(x=19，y=16)]) 


tolist0 方 法 可 以 将 其 转换 成 列表 : 


>>> 1 = p.tolist() 
> 
[Point2i(x=8@, y=1), Point2i(x=2, y=3), Point2i(x=10, y=18)] 


也 可 以 用 上 面 的 列表 创建 vector_Point2i 对 象 : 


>>> cv.vector Point2i(1) 
vector_Point2i(len=3, [Point2i(x=8, y=1), Point2i(x=2, y=3), Point2i(x=10, y=18)]) 


vector_ Point2i 的 初始 化 方法 实际 上 会 调用 vector Point2i 类 的 fromlist0 来 创建 对 象 : 


>>> cv.vector Point2i.fromlist(1) 
vector_Point2i(len=3, [Point2i(x=@, y=1), Point2i(x=2, y=3), Point2i(x=10, y=18)]) 


可 以 通过 Vector 类 的 elem type 属性 获得 元 素 的 类 型 : 


>>> cv.vector_ Point2i.elem type() 
<class 'pyopencv.cxcore_hpp_point ext.Point2i'> 


最 后 ，vector_vector_Point2i 类 型 是 一 个 元 素 类 型 为 vector_Point2i 的 Vector 对 象 。 和 前 面 
的 方法 类 似 ， 可 以 用 下 面 的 语句 创建 它 的 对 象 : 


>>> cv.vector_vector_Point2i([p，p[:2]]) 

vector_vector_Point2i(len=2, 

[vector_Point2i(len=3, [Point2i(x=8, y=1), Point2i(x=2, y=3), Point2i(x=10, y=10)]), 
vector_Point2i(len=2, [Point2i(x=8, y=1), Point2i(x=2, y=3)])]) 


12.1.5 ”在 图 像 上 绘图 


虽然 绘图 功能 不 是 OpenCV 的 重点 ,但 是 为 了 在 图 像 上 做 必要 的 标识 ，OpenCV 提供 了 一 
些 简单 的 绘图 功能 。 例 如 ， 使 用 line0 可 以 在 图 像 上 绘制 线段 。 让 我 们 先 看 看 它 的 文档 帮助 ， 
在 Python 中 输入 : 


>>> cv.line? 

[[ 省 略 ]] 

line( (Mat)img, (Point2i)pt1, (Point2i)pt2, (Scalar)color 

[, (object)thickness=1 [, (object)lineType=8 [，(object)shift=6]]]) 
-> None 


img 参数 的 类 型 是 Mat， 它 是 绘图 函数 的 目标 图 像 。ptl 和 pt 参数 的 类 型 为 Point2i, 分 别 
表示 线段 的 起 点 和 终点 。color 参数 的 类 型 为 Scalar， 通 过 它 设置 线段 的 颜色 。 最 后 用 “[]” 括 
起 来 的 部 分 是 可 选 参数 ， 其 中 thickness 设置 线段 的 粗细 ，lineType 设置 线段 的 绘制 方法 : 4 表 
示 4 连通 ，8 表示 8 连通 ，cv.CV_AA( 或 16) 表 示 反 锯齿 。 


Ww 文档 帮助 中 还 列 出 了 对 应 的 C++ 函数 的 调用 参数 ， 请 读者 自行 对 照 理解 。 
Scalar 是 一 个 由 4 个 双 精 度 浮 点 数 构成 的 类 型 ，line0 会 将 直线 所 通过 像素 的 每 个 通道 值 都 
设置 为 color 参数 中 对 应 的 值 。Scalar 对 象 也 可 以 使 用 CV_RGBO 来 创建 : 


>>> cv.CV_RGB(255，128，6) # 3 个 参数 分 别 为 红 、 绿 、 蓝 的 分 量 
Scalar([ 8. 128. 255. 8.]) 


由 上 面 的 结果 可 知 ，Scalar 中 的 4 个 浮 点 数 分 别 表示 : 蓝 、 绿 、 红 和 透明 度 。 虽 然 颜 色 值 
有 4 个 通道 ， 但 是 绘图 函数 并 不 能 利用 透明 度 信息 和 图 像 上 已 有 的 像素 数据 进行 颜色 混合 ， 它 
只 是 用 color 参数 的 值 覆 盖 图 像 的 像素 值 。 

为 了 绘制 半 透 明 的 图 形 ， 可 以 先 在 一 个 全 黑 的 图 像 上 进行 绘图 ， 然 后 将 目标 图 像 和 绘图 图 
像 进 行 混合 。 下 面 的 程序 演示 了 这 一 过 程 ， 结 果 如 图 12-2 所 示 ( 见 文 前 彩 播 )。 


sh opencv_draw.py 
之 _* ”使 用 图 像 混合 绘制 半 透明 的 直线 


import pyopencv as cv 


img = cv.imread("lena.jpg") 
img2 = cv.Mat(img.size(), cv.CV_8UC4) 


w, h = img.size().width, img.size().height 


def blend(img, img2): 


混合 两 幅 图 像 ， 其 中 img2 有 4 个 通道 
# 使 用 alpha 通道 计算 img2 的 混合 值 
br= img2[:5:,3:] / 255.0. 0 
a = 1 - b # img 的 混合 值 
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# 混 合 两 幅 图 像 
1me[:7::3] *= 3 9 
ne[: :3523] +e b * img2{:,:,:3] 
img2[:] = @ 
for i in xrange(6，w，w/16): 
cv.line(img2, cv.Point(i,8), cv.Point(i, h), © 
cv.Scalar(0, 0@, 255, i*255/w), 5) 


blend(img, img2) @ 
img2[:] = 8 
for i in xrange(6，h，h/16): 
cv.line(img2, cv.Point(8,i), cv.Point(w, i), 
cv.Scalar(@, 255, 8, i*255/h), 5) 
blend(img, img2) 


cv.namedWindow("Draw Demo") 
cv.imshow("Draw Demo", img) 
cv.waitKey(0) 


图 12-2 使 用 图 像 混合 绘制 半 透明 的 直线 


blendO 对 两 幅 图 像 进行 混合 , @ 先 用 img2 的 第 4 通道 计算 出 两 个 颜色 混合 用 的 数组 a 和 b。 
@ 使 用 a 和 b 将 img2 中 的 颜色 混合 到 img 中 。 为 了 减少 不 必要 的 内 存 分 配 ， 程 序 中 将 混合 公 
式 的 计算 分 为 两 步 。 混 合计 算 公式 如 下 : 


img 的 RGB 通道 = img 的 RGB 通道 {a + img2 的 RGB 通道 *b 


目 在 全 黑 图 像 img2 上 绘制 紧 条 直线 ， 请 注意 在 循环 中 我 们 改变 了 第 4 通道 的 值 ， 使 得 每 
条 直线 都 有 不 同 的 透明 度 。@ 最 后 调用 blend0， 将 img2 混合 到 img 中 。 
除了 line0 之 外 ，OpenCV 还 提供 了 circle0、ellipse0、rectangle0、polylines0、putTextO 等 


绘图 函数 。 请 读者 自行 研究 它们 的 用 法 。 
12.2 图 像 处 理 


OpenCV 的 图 像 处 理 功能 十 分 丰富 ， 本 节 以 二 维 卷 积 、 形 态 学 图 像 处 理 、 颜 色 填充 、 去 瑕 
疲 为 例 ， 简 要 地 介绍 OpenCV 的 图 像 处 理 功能 。 希 望 读 者 通过 这 些 实例 举一反三 ， 能 通过 阅读 
OpenCV 的 文档 尝试 更 多 的 图 像 处 理 功能 。 


12.2.1 二 维 卷 积 


图 像 处 理 中 最 基本 的 算法 就 是 将 图 像 和 某 个 卷 积 核 进行 卷 积 , 使 用 不 同 的 卷 积 核 可 以 得 到 
各 种 不 同 的 图 像 处 理 效果 。 OpenCV 提供 了 fiter2D0 来 完成 图 像 的 卷 积 运算 , 其 调用 方式 如 下 : 


filter2D(src, dst, ddepth, kernel, 
anchor=Point2i(x=-1, y=-1), delta=0, borderType=4) 


其 中 ，src 参数 是 原始 图 像 ，dst 参数 是 目标 图 像 。 函 数 运行 之 后 ，dst 的 大 小 和 通道 数 将 和 
src 相同。ddepth 参数 指定 目标 图 像 每 个 通道 的 数据 类 型 ， 负 数 表 示 目 标 图 像 的 数据 类 型 和 原 
始 图 像 相 同 。kernel 参数 设置 卷 积 核 ， 对 原始 图 像 的 每 个 通道 进行 卷 积 计算 ， 并 将 结果 存储 到 
目标 图 像 对 应 的 通道 中 。anchor 参数 指定 卷 积 核 的 锚 点 位 置 ， 当 它 为 默认 值 (-1,-D 时 ， 将 以 卷 
积 核 的 中 心 为 锚 点 。delta 参数 指定 在 将 计算 结果 存储 到 dst 中 之 前 ， 对 数值 的 偏 移 量 。 

filter2DO 的 卷 积 运算 过 程 如 下 : 

(1) 对 图 像 src 中 的 每 个 像素 点 (x,y)， 让 它 和 卷 积 核 的 锚 点 对 齐 。 

(2) 对 于 图 像 sre 中 与 卷 积 核 重 又 的 部 分 ， 计 算 像 素 和 卷 积 核 值 的 乘积 。 

(3) 图 像 dst 中 像素 点 (x,y) 的 值 为 上 面 所 有 乘积 的 总 和 。 

显然 ， 当 卷 积 核 的 尺寸 很 大 时 ， 上 述 方法 的 运算 速度 将 会 很 慢 。 因 此 对 于 较 大 的 卷 积 核 ， 
filter2DO 将 使 用 离散 傅立叶 变换 相关 的 算法 进行 卷 积 运算 。 

下 面 的 程序 演示 了 使 用 不 同 卷 积 核对 图 像 进行 处 理 之 后 的 效果 ， 如 图 12-3 所 示 ( 见 文 前 彩 插 )。 


- EE opencv filter2d.py 
污 _ ”使 用 filter2D0 制 作 各 种 图 像 处 理 效果 


import pyopencv as cv 
import numpy as np 
import matplotlib.pyplot as plt 


# 读 入 图 像 并 缩小 为 1/2 
imge = cv.imread("lena.jpg") 
size = img6.size() 
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w, h = size.width, size.height 
imgl = cv.Mat() 
Cv.resize(img0, img1, cv.Size(w//2, h//2)) © 


# 各 种 卷 积 核 

kernels = [ 
(u" 低 通 滤波 器 ",np.array([[1,1,1],[1,2,1],[1,1,1]])*6.1)， 
(u" 高 通 滤波 器 ",np.array([[@,-1,6],[-1,5,-1],[8,-1,6]]))， 
(u" 边 缘 检 测 ",np.array([[-1,-1,-1],[-1,8,-1],[-1,-1,-1]])) 

] 


index = @ 
for name, kernel in kernels: 
plt.subplot(131+index) 
# 将 卷 积 核 转换 为 Mat 对 象 
kmat = cv.asMat(kernel.astype(np.float), force_single_channel=True) © 
img2 = cv.Mat() 
cv.filter2D(img1, img2, -1, kmat) © 
# 由 于 matplot]lib 的 颜色 顺序 和 OpenCV 的 相反 ， 因 此 需要 进行 反 转 
plt.imshow(img2[:,:,::-1]) @ 
plt.title(name) 
index += 1 
plt.gca().set axis off() 
plt.subplots adjust(6.62, 8, 8.98, 1, 8.62, 8) 
plt.show() 


@ 为 了 显示 方便 ， 先 调用 resize0 将 图 像 缩小 为 原来 的 二 分 之 一 。@ 将 使 用 数组 定义 的 卷 积 
核 转 换 为 Mat 对 象 ， 这 里 使 用 force_single_channel 参数 保证 转换 之 后 的 Mat 对 象 为 单 通道 . @ 
调用 filter2D0 对 imgl 进行 卷 积 运算 , 结果 写 入 img2 中 , 并且 img2 的 像素 类 型 和 imgl 的 相同 。 
@ 使 用 matplotlib 显示 图 像 时 ， 需 要 将 Mat 对 象 中 通道 的 顺序 进行 反 转 。 


低 通 滤波 宙 高 通 滤 彼 器 边 卉 检测 
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图 12-3 使 用 fiter2DO 制 作 的 各 种 图 像 处 理 效果 


为 了 对 卷 积 核 的 图 像 处 理 效果 有 更 直观 的 认识 ， 读 者 可 以 运行 下 面 的 演示 程序 。 它 使 用 
TraitsUI 制作 了 一 个 简单 的 控制 界面 ， 在 此 界面 中 修改 卷 积 核 的 元 素 值 可 以 立即 看 到 卷 积 之 后 
的 图 像 效 果 。 


a ‘opencv_filter2d_demo.py 
修改 卷 积 核 ， 即 时 观察 图 像 处 理 效果 


有 些 特 殊 的 卷 积 核 可 以 表示 成 一 个 列 矢量 和 一 个 行 矢量 的 乘积 , 这 时 只 需要 将 原始 图 像 按 
顺序 与 这 两 个 矢量 进行 卷 积 即 可 ， 得 到 的 最 终结 果 和 直接 与 卷 积 核 进行 卷 积 的 结果 相同 。 由 于 
将 一 个 n*m 的 矩阵 分 解 成 了 两 个 n*l 和 1*m 的 矩阵 ， 因 此 对 于 较 大 的 卷 积 核 ， 能 大 幅度 地 提 
高 计算 速度 。OpenCV 提供 了 sepFilter2DO 进 行 这 种 分 步 卷 积 ， 其 调用 参数 如 下 : 


sepFilter2D(src, dst, ddepth, kernelX, kernelY, 
anchor=Point2i(x=-1, y=-1), delta=8, borderType=4) 


其 中 ，kemelX 和 kemelY 分 别 为 行 卷 积 核 和 列 卷 积 核 。 下 面 的 程序 比较 filter2DO 和 
sepFilter2DO 的 计算 速度 : 


办 ‘opencv_sepFilter2D.py 
用 sepFilter2DO 进 行 高 斯 模糊 卷 积 


import pyopencv as cv 
import numpy as np 
import time 


img = cv.asMat(np.random.rand(1666,1666)) © 


row = cv.getGaussianKernel(7, -1) @ 

col = cv.getGaussianKernel(5, -1) 

kernel = cv.asMat(np.dot(col[:], row[:].T), force_single_channel=True) © 
img2 = cv.Mat() 

img3 = cv.Mat() 


start = time.clock() 
cv.filter2D(img, img2, -1, kernel) @ 
print "filter2D:", time.clock() - start 


start = time.clock() 
cv.sepFilter2D(img, img3, -1, row, col) © 
print "sepFilter3D:", time.clock() - start 


print “error=", np.max(np.abs(img2[:] - img3[:])) © 


@ 首 先 , 随机 产生 一 个 比较 大 的 图 像 img。@ 调 用 getGaussianKemel0 分 别 获得 长 度 为 7 和 
长 度 为 5 的 两 个 高 斯 模糊 卷 积 核 row 和 col。 它 们 的 内 部 数据 如 下 : 
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>>> row 

Mat(rows=7, cols=1, nchannels=1, depth=6): 

array([[ 8.63125 ],[ 86.169375],[ 06.21875 ],[ 8.28125 ],[ 8.21875 ],[ 8.109375], 
[ 8.863125 ]]) 

>>> col 

Mat(rows=5, cols=1, nchannels=1, depth=6): 

array([[ 69.6625],[ 6.25 ],[ 8.375 ],[ 98.25 ],[ 8.8625]]) 


目 计 算 row 和 col 的 矩阵 乘积 kemel， 它 是 一 个 形状 为 (5, 7) 的 二 维 数 组 。@@ 分 别 使 用 
filer2DO 和 sepFilter2DO 对 图 像 img 进行 卷 积 ， 测 量 它们 的 计算 时 间 ，@ 并 输出 两 幅 结果 图 像 之 
间 的 最 大 误差 。 

程序 的 输出 如 下 : 


filter2D: 9.6468525686743 
sepFilter3D: 86.616361184942 
error= 6.66133814775e-16 


卷 积 核 的 尺寸 越 大 ， 计 算 时 间 的 差别 越 大 ， 请 读者 更 改 row 和 col 的 值 ， 观 察 计算 时 间 的 
差别 。 

由 于 卷 积 计算 很 常用 , 因此 OpenCV 提供 了 一 些 高 级 函数 ， 以 直接 完成 与 某 种 特定 卷 积 核 
的 卷 积 计算 。 例 如 平均 模糊 blur0、 高 斯 模糊 GaussianBlur0、 用 于 边缘 检测 的 差分 运算 Sobel0 
和 Laplacian0， 等 等 。 关 于 这 些 函数 的 用 法 请 读者 自行 参考 OpenCV 的 C++ 文档 ， 这 里 就 不 再 
举例 了 。 


12.2.2 ”形态 学 运算 

在 第 3.6 节 中 , 我 们 介绍 过 如 何 使 用 SciPy 的 图 像 处 理 模块 进行 形态 学 图 像 处 理 。 OpenCV 
也 提供 了 类 似 的 处 理 功能 。 例 如 ，dilate0 可 以 对 图 像 进行 膨胀 处 理 ，erode0 则 可 以 对 图 像 进行 
腐蚀 处 理 。 另 外 ，morphologyEx0 使 用 膨胀 和 收缩 实现 一 些 更 高 级 的 形态 学 处 理 。 这 些 函 数 都 
可 以 对 多 值 图 像 进 行 操作 ， 对 于 多 通道 图 像 ， 它 们 将 对 每 个 通道 进行 相同 的 运算 。dilate0 和 
erode0 的 调用 参数 相同 : 


dilate(src, dst, kernel, anchor=Point2i(x=-1, y=-1), iterations=1, ...) 


其 中 ，srec 参数 是 原始 图 像 ，dst 参数 是 处 理 之 后 的 图 像 ， 它 们 的 大 小 相同 。kemel 参数 是 
结构 元 素 ， 它 指定 针对 哪些 周围 像素 进行 计算 。anchor 参数 指定 锚 点 的 位 置 ， 默 认 值 为 结构 元 
素 的 中 心 。iterations 参数 指定 处 理 次 数 。 

morphologyEx0 的 参数 如 下 : 


morphologyEx(src, dst, op, kernel, anchor=Point2i(x=-1, y=-1), iterations=1, ...) 


它 比 dilate0 多 了 一 个 op 参数 ， 该 参数 指定 运算 的 类 型 。 


膨胀 运算 可 以 用 下 面 的 公式 描述 : 
dst(x,y)= kemele y) Osre(x +x',p+y") 


将 结构 元 素 的 锚 点 与 原始 图 像 中 的 每 个 像素 (x,y) 对 齐 之 后 , 计算 所 有 结构 元 素 值 不 为 0 的 
像素 的 最 大 值 ， 写 入 目标 图 像 的 (x,y) 像 素 点 。 而 腐蚀 运算 则 是 计算 所 有 结构 元 素 不 为 0 的 像素 
的 最 小 值 。 

morphologyEx() 的 高 级 运算 包括 : 

e MORPH OPEN: 开 运 算 , 可 以 用 来 区 分 两 个 靠 得 很 近 的 区 域 。 算法 为 先 腐蚀 后 膨胀 : 

dst=dilate(erode(src))。 

e MORPH_ CLOSE: 闭 运算 ， 可 以 用 来 连接 两 个 靠 得 很 近 的 区 域 。 算 法 为 先 膨胀 后 腐 

蚀 : dst=erode(dilate(src))。 

e MORPH GRADIENT: 形态 梯度 ， 能 够 找 出 图 像 区 域 的 边缘 。 算 法 为 膨胀 减 去 腐蚀 : 

dst=dilate(src) - erode(src)。 

e MORPH TOPHAT: 顶 帽 运算 。 算 法 为 原始 图 像 减 去 开 运算 : dst = src-open(src) 

e MORPH BLACKHAT: 黑 帽 运算 。 算 法 为 闭 运算 减 去 原始 图 像 : dst=close(src)-src 

下 面 的 程序 演示 了 上 述 形 态 学 图 像 处 理 的 效果 ， 图 12-4 是 其 界面 截图 。 请 读者 通过 此 界面 
修改 结构 元 素 、 处 理 类 型 以 及 迭代 次 数 等 参数 ， 并 观察 经 过 处 理 之 后 的 图 像 ， 理 解 各 种 运算 的 
公式 。 


opencv_morphology_demo.py 
¥ 形态 学 图 像 处 理 演示 


已。 [一 一 
下 
re [EEC 一 


12-4 ”形态 学 图 像 处 理 演示 界面 
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12.2.3 ”填充 一 floodFil 


填充 函数 floodFill0 在 图 像 处 理 中 经 常用 于 标识 或 分 离 图 像 中 的 某 些 特定 部 分 , 它 的 调用 
方式 有 两 种 : 


floodFill(image, seedPoint, newVal, 
loDiff=Scalar([ 6. 8. 8. 8.]), upDiff=Scalar([ 6. 6. 8. 9.])， 
flags=4) 


floodFill(image, mask, seedPoint, newVal, 
loDiff=Scalar([ 6. 98. 6. 8.]), upDiff=Scalar([ 8. 8. 98. 98.]), 
flags=4) 


其 中 ，image 参数 的 类 型 为 Mat， 它 是 需要 填充 的 图 像 。seedPoint 参数 的 类 型 是 Point， 它 
表示 填充 的 起 始点 , 也 称 为 种 子 点 。 newVal 参数 的 类 型 是 Scalar, 它 表示 填充 所 使 用 的 颜色 值 。 
loDiff 和 upDi 人 ff 参数 是 填充 的 下 限 容 差 和 上 限 容 差 。flags 参数 是 填充 的 算法 标志 。 

填充 从 seedPoint 参数 指定 的 种 子 坐标 开始 ， 图 像 中 与 当前 填充 区 域 颜色 相近 的 点 将 被 添 
加 到 填充 区 域 ， 从 而 逐步 扩大 填充 区 域 ， 直 到 没有 新 的 点 能 添加 进 填充 区 域 为 止 。 颜色 相近 的 
判断 方法 有 两 种 : 

e 默认 使 用 相 邻 点 为 基点 进行 判断 。 

e 如 果 开 启 了 flags 中 的 cv.FLOODFILL FIXED RANGE 标志 位 ， 那 么 将 以 种 子 点 为 

基点 进行 判断 。 

假设 图 像 中 某 个 点 (x,») 的 颜色 为 C(x,y) ，C 为 基点 颜色 , 那么 当下 面条 件 满足 时 ，(x,y) 
将 被 添加 进 填充 区 域 : 


Co —loDiff < C(x,y) < Co +hiDif 


此 外 ， 还 可 以 通过 flags 指定 相 邻 点 的 定义 : 4 连通 或 8 连通 。 

在 第 二 种 调用 方式 中 ，mask 参数 是 一 个 宽 和 高 都 比 image 大 两 个 像素 的 单 通道 8 位 图 像 。 
image 图 像 中 的 像素 (x, y) 与 mask 中 的 (x+1, y+1) 对 应 。 填 充 只 针对 mask 中 的 值 为 0 的 像素 进行 。 
进行 填充 之 后 ，mask 中 所 有 被 填充 的 像素 将 被 赋值 为 1。 如 果 只 希望 修改 mask， 而 不 对 原始 
图 像 进行 填充 ， 可 以 开启 flags 标志 中 的 cv.FLOODFILL MASK_ONLY。 

下 面 的 程序 演示 了 floodFill0 的 用 法 ， 其 界面 截图 如 图 12-5 所 示 。 在 图 像 上 用 鼠标 左 键 点 
选 填充 的 种 子 点 ， 通 过 界面 上 方 的 控件 可 修改 loDiff、upDiff 和 flags 等 参数 。 


a opencv_floodfill demo.py 
floodFill0 填 充 演示 程序 


[了 二 到 


图 12-5 ”填充 演示 程序 的 界面 截图 


本 程序 使 用 Chaco 库 显示 图 像 ， 并 制作 了 一 个 简单 的 Overlay 对 象 来 显示 填充 的 起 始点 。 
floodFill0 中 flags 参数 的 选项 如 下 : 


Options = { 
u" 以 种 子 为 标准 -4 联通 ":cv.FLOODFILL_FIXED_RANGE | 4， 
u" 以 种 子 为 标准 -8 联通 " :cv.FLOODFILL_FIXED_RANGE | 8， 
u" 以 邻 点 为 标准 -4 联通 " :4， 
u" 以 邻 点 为 标准 -8 联通 " :8 

1 


12.2.4 ”去 瑕 症 一 一 inpaint 


使 用 inpaint0 可 以 从 图 像 上 去 除 指定 区 域 中 的 物体 ， 可 以 用 于 去 除 图 像 上 的 水 印 、 划 痕 、 
污渍 等 瑕 羔 。 它 的 调用 参数 如 下 : 


inpaint(src, inpaintMask, dst, inpaintRange, flags) 


其 中 ，src 参数 是 原始 图 像 ，inpaintMask 参数 是 大 小 和 src 相同 的 单 通道 8 位 图 像 ， 其 中 
不 为 0 的 像素 表示 需要 去 除 的 区 域 。 dst 参数 用 于 保存 处 理 结果 。 inpaintRange 参数 是 处 理 半 径 ， 
半径 越 大 ， 处 理 时 间 越 长 ， 结 果 越 平滑 。flags 参数 用 于 选择 inpaint 的 算法 ， 目 前 有 两 个 候选 
算法 一 INPAINT NS 和 INPIANT TELEA。 

下 面 的 程序 演示 inpaint0 的 用 法 ， 其 界面 截图 如 图 12-6( 左 ) 所 示 。 右 上 图 中 用 白色 区 域 表 
示 inpaintMask 参数 中 不 为 0 的 像素 ， 即 需要 处 理 的 区 域 ， 右 下 图 显示 了 对 此 区 域 进 行 处 理 之 
后 的 效果 。 
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在 此 演示 程序 中 , 用 鼠标 在 图 像 上 绘制 出 需要 进行 处 理 的 区 域 , 程序 会 实时 显示 处 理 结果 。 
之 后 可 以 修改 “inpaint 半径 ”和 “inpaint 算法 ”等 设置 ， 实 时 观察 它们 对 处 理 结果 的 影响 。 如 
果 选区 过 大 ， 处 理 可 能 会 需要 较 长 时 间 ， 此 时 可 以 单 击 “ 保 存 结果 ”按钮 ， 用 当前 的 处 理 结果 
覆盖 原始 图 像 ， 并 清除 选区 ， 以 进行 下 一 轮 处 理 。 


时 A# ‘opencv_inpaint_ demo.py 
三 一。 inpaint0 演 示 程序 


ed EE 
a 


12-6 使 用 inpaint0 去 除 图 像 中 的 物体 


程序 中 使 用 Chaco 显示 图 像 ， 使 用 自 定义 的 CirclePainter 对 象 在 Overlay 层 绘制 并 保存 鼠 
标 轨迹 ， 然 后 使 用 OpenCV 的 画 圆 函数 circle0 将 CirclePainter 对 象 的 鼠标 轨迹 描绘 到 表示 处 理 
区 域 的 inpaintMask 图 像 之 上 。 


12.3 图 像 变 换 


12.3.1 几何 变换 


我 们 可 以 对 图 像 在 二 维 平面 上 进行 仿 射 变换 ， 在 三 维 空间 中 进行 透视 变换 。 仿 射 变换 相当 
于 将 二 维 平面 上 的 每 个 坐标 点 与 一 个 2*3 的 矩阵 相 乘 ， 得 到 新 的 坐标 ， 而 透视 变换 则 是 与 3*3 
的 矩阵 相 乘 。 原 本 平行 的 两 条 直线 在 经 过 仿 射 变换 之 后 仍然 是 平行 的 ， 而 经 过 透视 变换 之 后 ， 
它们 就 可 能 不 再 平行 了 。 

使 用 warpAffine0 可 以 对 图 像 进行 仿 射 变换 ， 其 调用 参数 如 下 : 


warpAffine(src，dst，M，dsize，flags=1，borderMode=9， 
borderValue=Scalar([ 86. 8. 8. 6.])) 


其 中 ，src 参数 是 变换 的 原始 图 像 ，dst 参数 是 变换 后 的 图 像 。dsize 参数 为 dst 的 尺寸 ，dst 
的 像素 类 型 和 src 的 相同 。M 参数 是 仿 射 变换 矩阵 ， 它 是 一 个 2*3 的 Mat 对 象 。flags 参数 是 内 
插 方式 ，borderMode 是 外 插 方式 ，borderValue 为 背景 颜色 。 关 于 这 些 参数 的 含义 请 读者 阅读 
OpenCV 的 文档 。 

假设 矩阵 M 的 各 个 元 素 如 下 : 


四 ao | 
qo an bi 
那么 仿 射 变换 可 以 用 下 面 的 公式 表示 : 


dst(x, y)= src(awox+aoy+bo,ayoxt+any+b,) 


为 了 理解 仿 射 变换 矩阵 中 每 个 参数 的 含义 ， 请 读者 运行 下 面 这 个 演示 程序 。 


sh ‘opencv_affine demo.py 
全 二 使 用 TraitsUI 交互 式 地 演示 warpAffine0 的 处 理 效果 


此 程序 使 用 TraitsUI 制作 了 一 个 可 以 编辑 
变换 矩阵 和 图 像 大 小 的 简单 界面 。 修 改 这 些 参 
数 时 , 将 调用 warpAffine0 实 时 更 新 图 像 进行 仿 
射 变换 之 后 的 效果 ， 如 图 12-7 所 示 ( 见 文 前 彩 
播 )。 图 中 设置 co 和 os 为 05， 它 们 使 图 像 的 
宽 和 高 都 缩小 为 原来 的 二 分 之 一 。ao 和 aa 为 
-0.3 和 0.3， 当 它们 为 符号 相反 、 绝 对 值 相同 的 
两 个 数 时 ， 其 效果 相当 于 对 图 像 进行 旋转 ， 否 12-7 使 用 TraitsUI 交互 式 地 演示 
则 图 像 将 会 从 矩形 变 成 平行 四 边 形 。5。 和 bb, 则 warpAffine0 的 处 理 效果 
分 别 决定 图 像 在 水 平方 向 和 垂直 方向 上 以 像素 为 单位 的 偏 移 量 。 

仿 射 变换 矩阵 中 有 6 个 参数 ， 因 此 只 需要 指定 变换 前 后 3 个 坐标 点 的 坐标 ， 就 可 以 通过 解 
线性 方程 组 获得 变换 矩阵 OpenCV 提供 了 getAffineTransform0 来 帮助 我 们 快速 完成 这 种 计算 : 


getAffineTransform(src, dst) 


src 和 dst 参数 是 变换 前 后 的 三 个 点 的 坐标 ， 它 们 都 是 vector_Point2f 对 象 。 下 面 的 代码 使 
用 getAffineTransform0 计 算出 一 个 以 原点 为 中 心 、 放 大 两 倍 的 仿 射 变换 矩阵 ; 


>>> src = cv.asvector_ Point2f(np.array([[8,8],[8,1],[1,8]],dtype=np.float32)) 
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>>> dst = cv.asvector Point2f(np.array([[8,8],[8,2],[2,8]],dtype=np.float32)) 
>>> cv.getAffineTransform(src, dst) 
Mat(rows=2, cols=3, nchannels=1, depth=6): 
array([[ 2., 8., 98.], 
Cl) 


warpPerspective0 和 warpAffine0 类 似 ， 也 对 图 像 进 行 几何 变换 ， 不 过 它 是 在 三 维 空间 中 进 
行 透视 变换 , 因此 它 的 变换 矩阵 是 3*3 的 矩阵 。 这 个 变换 矩阵 可 以 通过 getPerspectiveTransform() 
计算 。 

下 面 是 warpPerspective0 的 演示 程序 ， 其 运行 效果 如 图 12-8 所 示 ( 见 文 前 彩 插 )。 图 中 的 变 
换 矩 阵 使 用 getPerspectiveTransform0 计 算 ， 它 的 变换 源 坐 标点 分 别 为 图 像 的 左上 、 右 上 、 左 下 
和 右 下 4 个 点 ， 而 变换 目标 点 为 界面 上 所 输入 的 坐标 。 所 得 到 的 变换 矩阵 将 原始 图 像 4 个 角 上 
的 点 变换 为 图 中 箭头 所 指向 的 4 个 点 。 由 于 程序 的 结构 和 warpAffine0 的 仿 射 变换 演示 程序 类 
似 ， 这 里 就 不 再 详细 解释 了 。 


opencv_warpPerspective_demo.py 
党 使 用 warpPerspective0 对 图 像 进行 三 维 透视 变换 


图 12-8 ”使 用 warpPerspective0 对 图 像 进 行 三 维 透视 变换 


12.3.2 ” 重 映 射 一 remap 


图 像 的 各 种 变换 都 有 一 个 共同 特点 : 它们 从 原始 图 像 上 的 某 个 位 置 取出 一 个 像素 点 ， 并 把 
它 绘制 到 目标 图 像 上 的 另外 一 个 位 置 。 从 原始 坐标 到 目标 坐标 的 映射 不 一 定 是 一 对 一 的 关系 。 
OpenCV 提供 了 一 个 通用 的 图 像 映射 函数 remap0 来 完成 这 种 计算 。remap0 的 参数 如 下 : 


remap(src，dst，map1，map2，interpolation，borderMode=6， 
borderValue=Scalar([ 6. 86. 6. 9.])) 


其 中 ，src 参数 是 原始 图 像 ，dst 参数 是 目标 图 像 ， 最 终生 成 的 目标 图 像 的 大 小 和 像素 类 型 
都 和 src 相同。mapl 和 map2 参数 是 两 个 大 小 与 原始 图 像 相 同 的 Mat 对 象 ， 它 们 的 元 素 值 是 图 
像 dst 中 对 应 下 标的 像素 点 在 图 像 sc 中 的 坐标 值 , 其 元 素 类 型 可 以 是 整数 或 单 精度 浮 点 数 .map1 
中 存储 映射 的 X 轴 坐 标 , map2 中 存储 映射 的 Y 轴 坐 标 。 下 面 的 数学 公式 表示 了 这 种 映射 关系 ， 
其 中 , x 和 y 是 目标 图 像 中 每 个 像素 的 坐标 , 通过 mapl 和 map2 分 别 获得 它们 在 src 中 的 坐标 : 


dst(x, y) = src(mapl(x, y), map2(x, »y)) 
下 面 的 程序 使 用 remap0 将 原始 图 像 缩 小 为 原来 的 二 分 之 一 : 


Eo opencv remap resize py 


证 坟 。 使 用 remap0 缩 小 图 像 


img = cv.imread("lena.jpg") 

size = img.size() 

w, h = size 

img2 = cv.Mat() 

map1l, map2 = np.meshgrid( 
np.linspace(0,w*2,w).astype(np.float32), 
np.linspace(9,h*2,h).astype(np.float32), 

pi 

mapl = cv.asMat(map1) 

map2 = cv.asMat(map2) 

cv.remap(img, img2, mapl, map2, cv.INTER_LINEAR) 


缩小 之 后 的 图 像 img2 的 大 小 仍然 和 原始 图 像 img 相同 ， 但 是 其 中 只 有 左上 部 分 有 图 像 数 
据 , 因此 缩小 为 原始 图 像 的 二 分 之 一 。 为 了 直接 创建 两 个 元 素 为 单 精度 浮 点 数 的 映射 数组 map1 
和 map2， 这 里 使 用 和 np.mgrid 对 象 功 能 类 似 的 np meshgrid0 函 数 。 请 读者 查看 meshgrid0 的 函 
数 说 明 以 了 解 其 使 用 方法 。 

为 了 演示 remap0 的 强大 功能 ， 下 面 的 程序 让 用 户 输入 一 个 三 维 空间 的 曲面 函数 ， 程 序 将 
根据 此 函数 计算 的 曲面 对 图 像 进行 变形 ， 效 果 如 图 12-9 所 示 ， 就 像 将 图 像 贴 在 曲面 上 一 样 ( 见 
文 前 彩 插 )。 程 序 较 长 ， 这 里 只 给 出 计算 mapl 和 map2 数据 的 代码 : 


有 办 opencV_remap_demo.py 
洁 使 用 三 维 曲 面 和 remap0 对 图 像 进 行 变形 


厌 尖 兰 并 于 夫 半 订 变 图 一 人 0usdO 
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图 12-9 使 用 三 维 曲面 和 remapO 对 图 像 进行 变形 


def make_surf_map(func, r, w, h, de): 
""" 计 算 曲 面 函 数 func 在 [-r:r] 范 围 内 的 值 ， 并 进行 透视 投影 
视点 高 度 为 曲面 高 度 的 de 倍 +1""" 
y, x = np.ogrid[-r:r:h*1j, -r:r:w*+1j] 
z= func(x,y) © 
d= do*np.ptp(z) + 1.6 © 
mapl = x*(d-z)/d © 
map2 = y*(d-z)/d 
return (map1 / (2*r) + 9.5) * w, (map2 / (2*r) + 9.5) * h @ 


上 述 代码 片段 中 ， 先 计算 指定 范围 内 的 网 格 x、y，@ 然 后 计算 出 网 格 上 每 一 点 的 曲面 高 度 
z。@ 通 过 曲面 的 高 度 范围 和 d0 参数 决定 观察 点 的 高 度 。@ 然 后 利用 投影 变换 公式 ， 计 算出 表 
示 坐 标 变换 的 两 个 数组 mapl 和 map2。 其中, 投影 公式 的 示意 图 如 图 12-10 所 示 。@ 最 后 将 map1 
和 map2 的 取 值 范围 改 为 图 像 的 范围 。 


观察 点 一 
| 投影 公 趟 
A 8 改 理 雇 度 之 后 的 点 
号 标 茵 信 上 的 点 
村 从 区 \ / 


x 


图 12-10 ”投影 公式 示意 图 


12.3.3 直方 图 统计 


在 NumPy 中 ， 有 3 个 直方 图 统计 函数 一 -histogram0、histogram2d0 和 histogramdd0， 分 
别 对 应 一 维 数据 、 二 维 数据 及 多 维 数据 的 情况 。 下 面 的 程序 用 histogram0 和 histogram2d0 对 图 
像 的 颜色 分 布 进行 统计 ， 并 输出 如 图 12-11 所 示 的 统计 结果 ( 见 文 前 彩 插 )。 


A opencv_hist numpy.py 
让 ”用 Numpy 的 直方 图 统计 函数 进行 一 维和 二 维 统计 


import pyopencv as cv 
import numpy as np 
import matplotlib.pyplot as plt 


img = cv.imread("lena.jpg") 


plt.subplot(121) 
for i in xrange(3): 
hist, x = np.histogram(img[:,:,i].flatten(), bins=256, range=(8,256)) © 
plt.plot(@.5*(x[:-1]+x[1:]), hist, label="Ch %d" % i, lw=i+1) 
plt.legend(loc="upper left") 
plt.xlim((8,256)) 


hist2, x2, y2 = np.histogram2d( ®@ 
img[:,:,8].flatten(), img[:,:,2].flatten(), 
bins=(166,166)，range=[(8,256),(8,256)]) 


plt.subplot(122) 

plt.imshow(hist2, extent=(8,256,0,256), origin="lower") 
plt.ylabel("Che") 

plt.xlabel("Ch2") 

plt.show() 


上 268 EE 


图 12-11 “lenajpg” 的 3 个 通道 的 直方 图 统计 ( 左 )、 通 道 0 和 通道 2 的 二 维 直 方 图 统计 ( 右 ) 


注 沙 学 插 半 尖 阐 浪 获 国 一 人 DU3dO 
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@ 通 过 histogram0 对 图 像 img 的 3 个 通道 分 别 进行 一 维 直 方 图 统计 ， 由 于 被 统计 的 数组 必 
须 是 一 维 的 , 因此 这 里 调用 数组 的 flatten0 方 法 将 二 维 数组 转换 为 一 维 数组 。 通 过 range 参数 指 
定 统计 区 间 为 0 到 256, 通过 bin 参数 指定 将 统计 区 间 等 分 为 256 份 。histogram0 返 回 两 个 数组 
hist 和 x， 其 中 hist 为 统计 结果 ， 长 度 为 bin; x 为 统计 区 间 ， 长 度 为 bin+1。histfi] 的 值 为 数组 
中 “>=x[i]” 且 “<x[i+1]” 的 元 素 的 个 数 。 

@@ 用 histogram20 对 通道 0 和 通道 2 进行 二 维 直方 图 统计 。 被 统计 的 数组 是 两 个 一 维 数组 ， 
因此 也 需要 用 flatten0 方 法 进行 转换 。 它 们 分 别 为 图 像 中 通道 0 和 通道 2 的 数据 。bins 和 range 
参数 都 变 成 了 包含 两 个 元 素 的 序列 ， 分 别 与 两 个 数组 相对 应 。 返 回 的 统计 结果 hist2 是 一 个 二 
维 数组 ， 其 形状 由 bins 决定 。 第 0 轴 与 第 一 个 数组 相对 应 ,第 1 轴 与 第 二 个 数组 相对 应 。 它 是 
对 由 两 个 一 维 数组 的 对 应 元 素 所 构成 的 二 维 矢量 的 分 布 统计 结果 。 

观察 图 12-11( 左 ) 可 知 ， 通 道 2( 红 色 通 道 ) 的 值 较 大 ， 因 此 整个 图 像 呈 现 暖 色调 。 而 从 右 图 
不 但 可 以 得 出 通道 2 的 值 比 通道 0 较 大 的 结论 ， 还 可 以 看 到 几 处 分 布 比较 密集 的 领域 。 例 如 ， 
其 中 一 块 的 中 心 坐标 大 约 为 (207, 125), 这 说 明 图 像 中 红色 值 在 207 附近 、 蓝 色 值 在 125 附近 的 
像素 点 较 多 。 

OpenCV 中 的 直方 图 统计 函数 为 calcHist0。 它 支持 对 多 幅 图 像 进行 N 维 直方 图 统计 , 因此 
其 调用 参数 比较 复杂 。 下 面 是 使 用 calcHist0 对 一 副 图 像 进 行 二 维 直方 图 统计 的 例子 : 


g 办 opencv_hist_cv.py 
总 二 ”使 用 calcHist0 进 行 二 维 直 方 图 统计 


import pyopencv as cv 
import numpy as np 


img = Cv.imread("lena.jpg") 
result = cv.MatND() 


r= cv.vector_float32([6，256]) © 
ranges = cv.vector_vector float32([r, r]) 


cv.calcHist(cv.vector Mat([img]), © 
channels = cv.vector_int([6，1])， 
mask = cv.Mat(), 
hist = result， 
histSize=cv.vector_int([36，26])， 
ranges=ranges 


J 


hist，_x，_y = np.histogram2d(img[:,:,8].flatten(), img[:,:,1].flatten(), 
bins=(36,26)，range=[(8,256),(8,256)]) 


print np.all(hist == result[:]) © 


@calcHist0 的 第 一 个 参数 是 一 个 元 素 类 型 为 Mat 图 像 的 Vector 对象, 它 将 对 其 中 的 所 有 图 
像 进 行 统计 。channels 参数 是 一 个 整数 Vector 对 象 ， 指 定 要 统计 的 通道 ， 其 长 度 决定 了 直方 图 
的 维 数 。mask 参数 是 一 个 Mat 对 象 ， 可 以 用 它 对 图 像 进行 遮 单 ， 从 而 只 统计 图 像 中 的 部 分 区 
域 ， 本 例 中 使 用 空 Mat 对 象 ， 表 示 对 图 像 上 所 有 的 点 进行 统计 。hist 参数 指定 直方 图 的 统计 结 
果 ， 因 为 它 可 以 存储 任意 维 数 的 统计 结果 ， 因 此 它 是 一 个 MatND 对 象 。histSize 参数 是 一 个 整 
数 Vector 对 象 ， 用 来 指定 各 个 通道 的 等 分 区 域 数 ， 和 histogram2d0 的 bins 参数 意义 相同 。 

@ranges 参数 和 histogram2d0 的 range 参数 意义 相同 ， 不 过 它 是 一 个 类 型 为 vector vector 
float32 的 Vector 对 象 , 创建 起 来 比较 费事 。 它 的 每 个 元 素 都 是 一 个 包含 两 个 单 精度 浮 点 数 的 Vector 
对 象 。 绰 最 后 和 histogram2d0 的 计算 结果 进行 比较 。 

计算 出 直方 图 之 后 ， 我 们 可 以 用 calcBackProject0 将 图 像 中 的 每 点 替换 为 它 在 直方 图 中 对 
应 的 值 。 于 是 ， 在 直方 图 中 出 现 次 数 越 高 ， 图 像 中 对 应 的 像素 就 越 亮 。 我 们 可 以 用 这 种 方法 找 
出 图 像 中 和 直方 图 相 匹配 的 区 域 。 让 我 们 用 一 个 实际 的 例子 来 说 明 : 


opencV_back_ projectpy | 
坊 - 使 用 calcBackProjectO 寻 找 颜色 近似 的 区 域 


程序 的 输出 如 图 12-12 所 示 。 它 在 图 像 “fiuitsjpg”( 上 中 图 ) 中 寻找 和 图 像 “fruits_section.jpg” 
(上 左 图 ) 颜 色 近 似 的 部 分 ( 见 文 前 彩 插 )。 


厌 尖 兰 并 于 过 半 序 变 图 一 人 0usdO 


图 12-12 使 用 直方 图 的 Back Project 寻找 图 像 中 的 橙子 部 分 


import pyopencv as cv 
import numpy as np 


img = cv.imread("fruits_section.jpg") © 
img_hsv = cv.Mat() 
Cv.cvtColor(img, img_hsv, cv.CV_BGR2HSV) 
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channels = cv.vector_int([6，1]) 
result = cv.MatND() 


r= cv.vector_float32([86，256]) 
ranges = cv.vector_vector_float32([r，r]) 


cv.calcHist(cv.vector_Mat([img_hsv])，channels，cv.Mat()， © 
result，cv.vector_int([46，46])，ranges) 


result[:] /= np.max(result[:]) / 255 © 


@ 首 先 载 入 颜色 匹配 的 模板 图 像 ， 并 通过 cvtColor0 将 图 像 中 3 个 通道 的 数据 从 蓝 、 绿 、 
红 变换 为 色相 、 饱 和 度 和 明度 。cvtColor0 可 以 在 多 种 颜色 表示 法 之 间 进 行 转换 ， 通 过 第 3 个 参 
数 指定 颜色 的 转换 算法 , 具体 的 候选 项 请 读者 查看 OpenCV 的 API 文档 。 @ 调 用 calcHist0 对 模 
板 图 像 的 色相 和 饱和 度 这 两 个 通道 进行 二 维 直方 图 计算 。 在 色相 和 饱和 度 空 间 进行 颜色 匹配 ， 
能 够 得 到 较 好 的 匹配 结果 。@ 为 了 后 续 的 calcBackProject0 计 算 不 越界 , 这 里 将 直方 图 的 最 大 值 
缩小 到 255。 图 12-12( 上 右 图 ) 为 所 计算 的 直方 图 。 


img2 = cv.imread("fruits.jpg") @ 
img_hsv2 = cv.Mat() 
cv.cvtColor(img2, img_hsv2, cv.CV_BGR2HSV) 


img_bp = cv.Mat() 

cv.calcBackProject(cv.vector Mat([img hsv2]), © 
channels=channels, 
hist=result, 
backProject=img_bp, 
ranges = ranges) 


@ 载 入 目标 图 像 ， 然 后 通过 cvtColor0 进 行 颜 色 转 换 。@ 调 用 calcBackProject0 将 目标 图 像 
中 每 个 像素 的 颜色 变换 为 它 在 直方 图 中 对 应 的 值 。 它 的 第 一 个 参数 是 一 个 图 像 Vector 对 象 , hist 
参数 指定 直方 图 ，backProject 参数 指定 计算 结果 ， 它 是 一 个 单 通道 的 形状 和 数值 类 型 与 输入 图 
像 相同 的 图 像 。channels、ranges 参数 和 calcHist0 的 相同 。 图 12-12( 下 左 图 ) 为 calcBackProjectO 
的 计算 结果 。 


img th = cv.Mat() 
cv.threshold(img_ bp, img th, 180, 255, cv.THRESH_BINARY) © 


@ 调 用 threshold0 对 calcBackProject0 的 输出 图 像 进 行 二 值 化 处 理 ,参数 THRESH_BINARY 
指定 了 二 值 化 处 理 的 方法 , 它 将 图 像 中 值 小 于 等 于 180 的 点 都 设置 为 0, 大 于 180 的 设置 为 255。 
请 读者 查看 API 文档 以 了 解 更 多 的 二 值 化 方法 。 图 12-12( 下 中 图 ) 为 二 值 化 的 结果 。 


struct = np.ones((3,3), np.uint8) 
struct mat = cv.asMat(struct, force_single_channel=True) 


img mp = cv.Mat() 


cv.morphologyEx(img_th, img mp, cv.MORPH CLOSE, struct mat, iterations=5) @ 


@ 最 后 对 二 值 化 之 后 的 图 像 进行 形态 学 图 像 处 理 。 使 用 5 次 开 运 算 ， 将 图 像 中 分 散 的 区 域 
连接 成 一 个 大 区 域 。 图 12-12( 下 右 图 ) 为 最 终结 果 , 它 的 白色 区 域 正好 对 应 目标 图 像 中 橙子 的 部 
分 。 我 们 还 可 以 对 这 个 结果 进行 一 些 处 理 : 例如 使 用 闭 运算 消除 一 些 杂 点 ， 然 后 找 出 图 像 中 面 
积 最 大 的 区 域 。 

这 种 方法 也 可 以 用 于 在 视频 中 跟踪 一 个 颜色 鲜明 的 物体 。 在 跟踪 物体 之 前 ， 首 先 对 一 幅 物 
体 充满 整个 画面 的 图 像 进 行 直方 图 统计 ， 然 后 对 视频 后 续 的 帧 使 用 calcBackProject0 进 行 计算 。 


12.3.4 ”二 维 离散 傅立叶 变换 
图 像 数据 可 以 看 做 一 个 二 维 离散 信号 ， 对 其 进行 二 维 离散 傅立叶 变换 ， 能 将 其 转换 为 频 域 


信号 ， 将 原始 图 像 分 解 为 众多 二 维 正弦 波 的 全 加。 由 于 NumPy 已 经 提供 了 二 维 离 散 傅立叶 变 
换 的 函数 ， 因 此 本 节 主 要 使 用 NumpPy 的 相关 函数 进行 说 明 。 


为 了 更 好 地 理解 本 节 介绍 的 内 容 , 需要 读者 掌握 离散 储 立 叶 变 换 相关 的 知识 。 在 实战 
本 ”篇 的 第 15 章 有 -一 维 离散 傅立叶 变换 的 详细 论述 。 


我 们 知道 ， 对 一 维 的 N 点 实数 信号 x 进行 快速 傅立叶 变换 (FFT) 之 后 ， 可 得 到 表示 频 域 信 
号 的 N 个 复数 的 数组 X。 但 是 数据 的 信息 量 并 没有 增加 ， 这 是 因为 : 

e 下 标 为 0 和 N/2 的 两 个 复数 的 虚数 部 分 为 0。 

。 下 标 为 1 和 N-i 的 两 个 复数 共 印 ， 也 就 是 其 虚数 部 分 数值 相同 、 符 号 相反 。 

同样 ， 对 于 一 个 N*N 的 二 维 实数 信号 x 进行 二 维 快速 傅立叶 变换 之 后 ， 可 得 到 表示 频 域 
信号 的 N*N 个 复数 元 素 的 数组 XX。 其 中 ，X[ij] 和 X[N-LN-j] 共 思 ， 并 且 X[0, 0]、X[0, N/2]、 
X[N/2, 0]、X[N/2, N/2]4 个 元 素 的 虚 部 为 0。 下 面 我 们 用 程序 验证 一 下 : 


>>> import numpy as np 

>>> from numpy import fft 

>>> a = np.random.rand(8,8) 

>>> b = fft.fft2(a) # 将 空域 信号 a 转换 为 频 域 信号 b 


首先 载 入 相关 的 库 ， 并 且 创 建 一 个 8*8 的 随机 数 数组 a, 通过 住 20 得 到 表示 频 域 信号 的 数 
组 b。 让 我 们 验证 一 下 b 的 对 称 性 : 


>>> b[2,3]，b[8-2,8-3] # 应 该 是 共 因 复 数 
((-8.70691285658224157+1.5149998661921564j)， 
(-0.7069128565822419-1.5149998681921568j)) 

>>> np.allclose(b[1:,1:]，b[7:6:-1,7:6:-1].conj()) 
True 


注 沙 芳 振 生涯 半 六 获 国 一 人 DU9dO 
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通过 数组 的 conj( 方 法 可 以 获得 其 共 生 数 组 。 由 于 存在 计算 误差 ， 我 们 使 用 allcloseO 比 较 
两 个 数组 的 对 应 元 素 是 否 都 足够 相似 。 下 面 看 看 那 4 个 虚 部 为 0 的 元 素 : 


3>> bl:s4.574] 
array([[ 31.95957638+6.j， 1.85667587+6.j]， 
[ -4.64227716+8.j， -2.31274175+8.j]]) 


频 域 信号 通过 ift20 可 以 转换 回 空域 信号 ， 其 结果 和 原始 的 空域 信号 完全 相等 。 但 是 iffi0 
得 到 的 仍然 是 一 个 复数 数组 ， 只 是 每 个 元 素 的 虚 部 都 十 分 接近 于 0: 


>>> c = fft.ifft2(b) # 将 频 域 信号 转换 回 空域 信号 

>>> a[1,2], c[1,2] 

(8.72192897413988666, (8.72192897413988677-1.1891723119464234e-16j)) 
>>> np.allclose(a，c) # 和 原始 信号 进行 比较 


True 


频 域 信号 中 的 每 个 元 素 都 对 应 空域 信号 中 的 一 个 二 维 正弦 波 , 如 果 只 选择 将 频 域 信号 中 的 
一 部 分 转换 回 空域 信号 ， 那 么 就 相当 于 对 空域 信号 进行 了 滤波 处 理 。 下 面 的 程序 演示 了 将 频 域 
信号 中 不 同 区 域 转换 回 空域 信号 之 后 的 滤波 效果 ， 其 输出 如 图 12-13 所 示 。 


opencv_numpy_ffti2d.py 
六 于。 演示 频 域 信 号 中 各 个 区 域 对 应 的 空域 信号 


图 12-13 (左上 ) 用 储 20 计 算 的 频 域 信号 ，( 中 上 ) 使 用 全 shiftO 移 位 之 后 的 频 域 信号 ， 
(其 他 ) 各 个 区 域 对 应 的 空域 信号 


下 面 分析 此 程序 中 进行 滤波 部 分 的 代码 : 


N= 256 


img = cv.imread("lena_ful1.jpg") 

img2 = cv.Mat() 

Cv.cvtColor(img, img2, cv.CV_BGR2GRAY) 
img = cv.Mat() 

cv.resize(img2, img, cv.Size(N, N)) 


首先 载 入 一 幅 彩 色 图 像 , 并 将 其 转换 为 灰 度 图 像 。 由 于 FFT 运算 的 最 佳 大 小 为 2 的 整数 次 
究 ， 因 此 使 用 resize0 将 图 像 的 大 小 改 为 256*256。 


fimg = fft.fft2(img[:]) 
mag_img = np.1og16(np.abs(fimg)) 
Shift mag img = fft.fftshift(mag_img) 


然后 计算 图 像 img 的 频 域 信号 fmg， 由 于 它 是 一 个 复数 数组 ， 为 了 能 将 其 作为 图 像 显示 ， 
我 们 计算 它 的 每 个 元 素 的 模 值 ， 并 取 对 数 ， 得 到 数组 mag _ img。 图 12-13( 左 上 ) 为 mag img 的 
显示 效果 。 模 值 图 像 的 4 个 角 与 低频 信号 对 应 ， 中 心 与 高 频 信号 对 应 。 由 于 4 个 角 附 近 较 亮 ， 
这 说 明 原始 图 像 的 低频 成 分 较 多 ， 这 符合 一 般 图 像 信 号 的 规律 。 

为 了 更 好 地 观察 频 域 信 号 ， 我 们 使 用 ffshif0 对 mag img 进行 移 位 ， 得 到 数组 
shift mag _ img。 图 12-13( 中 上 ) 为 移 位 之 后 的 模 值 图 像 。 人 hshifti0 将 两 个 对 角 线 上 的 方块 对 调 ， 即 
1、3 象限 对 调 ，2、4 象限 对 调 。 这 样 一 来 ， 图 像 的 中 部 与 低频 对 应 ，4 个 角 与 高 频 信号 对 应 。 


rects = [(80,125,85,130), (90,90,95,95), 
(150, 10, 250, 250), (110, 110, 146, 146)] 

filtered results = [] 

for i, (x@, y0, x1, y1) in enumerate(rects): 
mask = np.zeros((N，N)，dtype=np.bool) © 
mask[x@:x1+1, y8:y1+1] = True @ 
mask[N-x1:N-x@+1, N-y1l:N-y8+1] = True © 
mask = fft.fftshift(mask) @ 
fimg2 = fimg * mask © 
filtered img = fft.ifft2(fimg2).real @ 
filtered results.append(filtered img) 


最 后 ， 我 们 选择 频 域 信 号 中 的 一 部 分 ， 将 其 转换 回 空域 信号 。 图 12-13 的 右上 图 和 下 排 的 
图 ， 分 别 显示 中 上 图 中 4 个 矩形 区 域 所 对 应 的 空域 图 像 。 

@mask 是 一 个 布尔 数组 , 其 形状 和 频 域 信号 数组 一 样 。 @ 将 其 中 坐标 在 指定 矩形 范围 之 内 
的 元 素 设置 为 True。 利 我 们 需要 同时 选择 共 斩 对 称 的 部 分 ， 否 则 通过 ift20 转 换 回 空域 信号 时 
虚 部 将 不 会 为 0。@ 通 过 fishiftO 对 mask 数组 进行 移 位 ， 使 得 它 和 频 域 信号 fimg 匹配 。 

@ 接 下 来 将 频 域 信号 fimg 与 mask 相 乘 ， 得 到 在 频 域 进 行 滤波 之 后 的 频 域 信号 fmg2。@ 
然后 调用 ift20 将 fimg2 转换 回 空域 信号 。 

为 了 帮助 读者 理解 频 域 信号 和 空域 信号 之 间 的 关系 ， 本 书 为 读者 提供 了 一 个 实时 演示 程 
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序 ， 其 界面 如 图 12-14 所 示 ( 见 文 前 彩 插 )。 在 左边 的 频 域 模 值 图 像 上 用 鼠标 绘制 多 边 形 区 域 ， 
按 住 Shift 键 可 以 绘制 多 个 区 域 。 中 间 的 图 像 显 示 根 据 用 户 所 绘制 的 多 边 形 计 算 的 谈 单 数组。 
右边 的 图 像 为 频 域 信号 经 过 遮 日 处 理 之 后 所 转换 成 的 空域 信号 。 

程序 采用 TraitsUI 制作 界面 ， 使 用 Chaco 绘图 库 进 行 快速 绘图 ， 使 用 OpenCV 的 fillPoly0 
在 遮 日 数组 上 绘制 多 边 形 填充 区 域 。 程 序 中 已 经 给 出 了 较为 详细 的 注释 ， 请 感 兴趣 的 读者 自行 
研究 ， 这 里 就 不 再 进行 说 明了 。 


4 ‘opencv_ffi2d_ demo.py 
守 一 ”实时 演示 图 像 的 频 域 滤波 


图 12-14 ”实时 演示 频 域 滤波 ，( 左 ) 频 域 的 模 值 图 像 ，( 中 ) 频 域 遮 单 图 像 ，( 右 ) 滤 波 之 后 的 空域 图 像 


12.4 像 识 别 


OpenCV 除了 能 够 对 图 像 进 行 各 种 处 理 和 变换 之 外 ， 它 还 提供 了 大 量 的 图 像 识别 函数 。 
12.4.1 用 霍 夫 变换 检测 直线 和 贺 


用 霍 夫 变换 (Hough Transform) 能 够 找 出 图 像 中 的 直线 和 圆 。OpenCYV 提供 了 如 下 3 种 霍 夫 
变换 相关 的 函数 : 

e HoughLines0: 检测 图 像 中 的 直线 。 

e HoughLinesP0: 检测 图 像 中 的 直线 段 。 

e HoughCircles0: 检测 图 像 中 的 圆 。 

下 面 的 演示 程序 使 用 HoughLinesPO 和 HoughCircles0 进 行 线段 和 圆 的 检测 。 它 们 的 各 种 参 
数 均 可 以 在 控制 面板 中 进行 调整 ， 运 行 界面 如 图 12-15 所 示 ( 见 文 前 彩 插 )。 


有 # opencv_hough demo.py 
全 一 用 霍 夫 变 换 寻 找 图 像 中 的 直线 和 圆 


图 12-15 用 霍 夫 变换 寻找 图 像 中 的 直线 和 圆 
由 于 程序 较 长 ， 这 里 仅 对 和 图 像 检 测 相关 的 代码 进行 说 明 : 


self.img = cv.imread("stuff.jpg") 

self.img gray = cv.Mat() 

Cv.cvtColor(self.img, self.img gray, cv.CV_BGR2GRAY) 

self.img_smooth = self.img_ gray.clone() 

cv.smooth(self.img gray, self.img_ smooth, cv.CV_GAUSSIAN, 7, 7, 9, 8) 


首先 在 _init 0 中 初始 化 了 3 个 属性 一 一 mg、img_gray 和 img_smooth。img 是 一 幅 RGB 
图 像 , 使 用 cvtColor0 将 其 转换 为 灰 度 图 像 mg_gray。 然后 使 用 smooth0 对 灰 度 图 像 进行 高 斯 模 
糊 , 得 到 img_smooth。 后面 的 代码 将 对 img_gray 进行 直线 检测 ,对 img_smooth 进行 圆 形 检测 。 

界面 中 的 所 有 调节 控件 都 分 别 和 一 个 Trait 属性 相对 应 , 当 属性 值 发 生变 化 时 将 调用 redraw0 
方法 ， 按 照 最 新 的 参数 设置 进行 检测 ， 并 显示 检测 结果 。 下 面 介 绍 redraw0 方 法 中 的 代码 : 


edge_img = cv.Mat() 
# 边缘 检测 
cv-Canny(self.imng gray, edge_img, self.th1, self.th2) 


由 于 HoughLinesPO 需 要 针对 二 值 图 像 进行 操作 ,因此 我 们 先 用 Canny0 对 灰 度 图 像 进行 边 


缘 检 测 ， 得 到 一 幅 二 值 图 像 edge_ img。Canny0 有 两 个 阅 值 参数 ， 它 们 直接 影响 边缘 检测 的 结 
果 。 闵 值 越 小 ， 从 图 像 中 检测 出 来 的 边缘 细节 越 多 。 


http://zh.wikipedia.org/zh-cn/Canny 算 子 
维基 百科 关于 Canny 算 子 的 说 明 


# 计算 结果 
if self.show_canny: 
show_img = cv.Mat() 
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Cv.cvtColor(edge img, show img, cv.CV_GRAY2BGR) 
else: 
show img = self.img.clone() 


为 了 观察 Canny0 的 计算 结果 , 在 界面 中 有 一 个 名 为 “显示 结果 ”的 复 选 框 , 与 之 对 应 的 Trait 
属性 为 show_canny。 为 了 在 图 像 中 使 用 不 同 颜色 绘制 直线 和 贺 , 我 们 需要 一 幅 彩 色 图 像 来 保存 
最 终 的 显示 效果 。 因 此 ， 当 show_canny 为 True 时 ， 使 用 cvtColor0 将 边缘 检测 结果 edge_ img 转 
换 为 彩色 图 像 show_img。 当 show_canny 为 False 时 ， 将 原始 图 像 复制 一 份 并 存储 到 show_img 中 。 


# 线段 检测 
theta = self.theta / 186.6 * np.pi 
lines = cv.HoughLinesP(edge_img，@ 
self.rho, theta, self.hough th, self.minlen, self.maxgap) 
for line in lines: @ 
cv.line(show_img, 
cv.aspPoint(line[:2])， © 
cv.asPoint(line[2:]), 
cv.CV_RGB(255, 8, 0), 2) 


@ 接 下 来 调用 HoughLinesPO 对 边缘 检测 之 后 的 二 值 图 像 进行 线段 检测 。HoughLinesPO 返 
回 一 个 vector_Vec4i 对 象 lines， 它 是 一 个 Vec4i 对 象 的 序列 ， 其 中 每 个 Vec4i 对 象 保存 线段 的 
两 个 端点 的 坐标 。@ 对 lines 中 的 每 个 Vec4i 对 象 进行 迭 代 ， 用 line0 绘 制 线段 ，@ 用 asPointO 
创建 表示 线段 两 个 端点 的 Point 对 象 。 在 Vec4i 对 象 中 ， 前 两 个 值 表 示 线段 的 起 点 坐标 ， 后 两 
个 值 表示 线段 的 终点 坐标 。 

为 了 了 解 参数 的 含义 ， 我 们 先 学 习 一 下 直线 霍 夫 变 换 的 原理 。 

图 像 中 的 每 条 直线 都 可 以 用 方程 y=ke+tm 表示 。 由 于 参数 k 和 直线 与 X 轴 的 夹 角 之 间 并 不 
是 线性 关系 ， 因 此 我 们 将 直线 方程 改写 为 一 -以 直线 到 原点 的 距离 x 和 直线 与 X 轴 的 夹 角 6 为 


参数 ， 如 图 12-16 所 示 : 
( | ( 亲 ) 
7 =| -一 -一 |x+| 一 
sin0 sin0 


12-16 用 r 和 0 表示 的 直线 


经 过 图 像 中 某 个 白色 的 点 (xo,yo) 的 直线 参数 > 和 0 满足 如 下 关系 : 


r=x0:cosO+yo:sin0 


它 是 一 条 在 2- 空间 中 的 正弦 曲线 。 所 谓 霍 夫 变换 ， 是 指 对 于 原始 图 像 中 的 每 个 白色 点 
Go,yo) ， 绘 制 它们 在 9 一 ~ 空间 中 对 应 的 正弦 曲线 。 众 多 正弦 曲线 的 相交 点 (9,m ) 就 是 原始 图 
像 中 的 一 条 直线 。 图 12-17 是 一 个 简单 的 例子 。 其 中 ， 左 图 中 的 4 个 圆 点 构成 一 条 直线 ， 右 图 
中 与 它们 对 应 的 正弦 曲线 (图 中 的 实 线 ) 相 交 于 一 点 , 而 与 三 角 点 对 应 的 正弦 曲线 (虚线 ) 则 不 经 过 
此 点 ( 见 文 前 彩 插 )。 
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图 12-17 霍 夫 变换 示意 图 


在 实际 计算 时 , 我 们 使 用 一 个 表示 9 空间 的 灰 度 图 像 作为 累加 器 , 其 中 每 个 点 对 经 过 此 
点 的 正弦 曲线 进行 计数 。 然 后 通过 阔 值 找 出 累加 器 中 所 有 的 峰值 点 ， 这 些 峰 值 点 对 应 的 -~ 坐 
标 就 是 原始 图 像 中 的 直线 参数 。 

HoughLinesPO 的 参数 如 下 : 


HoughLinesP( ;image，rho，theta，threshold，minLineLength=8，maxLineGap=6) 


其 中 ，image 参数 为 进行 直线 检测 的 图 像 ，tho 和 theta 参数 分 别 为 累加 器 中 每 个 点 所 表示 的 
r 和 9 的 大 小 。 其 中 ，tho 的 单位 是 像素 点 ，theta 是 以 弧度 表示 的 角度 。 值 越 小 ， 累 加 器 的 尺寸 
越 大 ， 最 后 寻找 出 的 直线 的 参数 精度 越 高 ， 但 是 运算 时 间 也 越 长 。threshold 参数 是 在 累加 器 中 寻 
找 峰 值 时 所 使 用 的 阔 值 , 即 只 有 大 于 此 值 的 峰值 点 才 被 认为 与 某 条 直线 对 应 。 由 于 HoughLinesPO 
检测 的 是 图 像 中 的 线段 ， 因 此 minLineLength 参数 指定 线段 的 最 小 长 度 ，maxLineGap 参数 指定 
线段 的 最 大 间隙 。 当 有 多 条 线段 共 线 时 ， 间 隙 小 于 此 值 的 线段 将 被 合并 为 一 条 线段 。 


# 圆 形 检测 
circles = cv.HoughCircles(self.img_ smooth, 3, @ 
self.dp, self.mindist, paraml=self.paraml, param2=self.param2) 
for circle in circles: 
cv.circle(show img, 
Cv.Point(int(circle[8]), int(circle[1])), int(circle[2]), © 
cv.CV_RGB(0, 255, 8), 2) 
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@ 接 下 来 寻找 圆 形 。 由 于 HoughCircles0 内 部 会 对 图 像 进行 边缘 检测 ， 因 此 这 里 使 用 灰 度 
图 像 。 为 了 减 小 噪声 影响 ， 我 们 使 用 模糊 之 后 的 图 像 。HoughCircles0 的 参数 如 下 : 


HoughCircles(image, method, dp, minDist, param1=180, param2=1860, minRadius=8, 
maxRadius=6) 


其 中 ，method 参数 为 圆 形 检测 的 算法 ， 目 前 OpenCV 中 只 实现 了 一 种 检测 算法 一 一 
CV_HOUGH GRADIENT。 由 于 PyOpenCV 中 没有 定义 此 常数 ， 因 此 我 们 直接 使 用 它 所 对 应 
的 整数 值 3。dp 参数 和 直线 检测 中 的 mho 参数 类 似 ， 决 定 了 检测 的 精度 ，dp=1 时 累加 器 的 分 辨 
率 和 输入 图 像 相同 ，dp=2 时 累加 器 的 分 辩 率 为 输入 图 像 的 一 半 。minDist 参数 是 检测 到 的 所 有 
圆 的 圆心 之 间 的 最 小 距离 , 当 它 过 小 时 会 检测 出 很 多 近似 的 圆 形 , 过 大 则 可 能 会 漏 掉 一 些 结果 。 

paraml 和 param2 参数 是 和 检测 算法 相关 的 参数 .其 中 ,paraml 参数 相当 于 边缘 检测 Canny0 
的 第 二 个 冰 值 ，Canny0 的 第 一 个 阔 值 自动 设置 为 它 的 一 半 。param2 参数 是 累加 器 上 的 阔 值 ， 
它 的 值 越 小 ， 检 测 出 的 圆 形 越 多 。minRadius 和 maxRadius 参数 指定 圆 形 的 半径 范围 ， 默 认 都 
为 0， 表 示范 围 不 限 。 

@HoughCircles0 返 回 一 个 vector Vec3f 对 象 circles， 它 是 一 个 Vec3f 对 象 的 序列 ， 其 中 的 
每 个 Vec3f 对 象 保存 圆心 坐标 和 半径 。 由 于 Vec3f 对 象 中 的 数值 为 浮 点 数 ， 因 此 在 调用 circle0 
绘制 圆 形 时 ， 需 要 将 它们 转换 成 整数 。 

由 于 圆 形 有 3 个 参数 一 -圆心 X 坐标 、 圆 心 Y 坐标 和 半径 ， 如 果 直 接 使 用 三 维 累加 器 ， 
计算 效率 太 低 。 并 且 由 于 累加 器 中 每 个 点 的 累计 次 数 不 能 足够 多 ， 会 出 现 很 多 局 部 峰值 ， 这 也 
会 影响 检测 结果 。 因 此 ，HoughCircles0 使 用 了 一 种 被 称 为 霍 夫 梯度 的 算法 来 进行 圆 形 检测 。 
它 的 计算 步 又 如 下 : 

(1) 首先 将 原始 图 像 经 过 边缘 检测 算法 获得 一 张 边缘 图 像 ， 这 里 使 用 Canny0 进 行 边缘 检 
测 ， 并 使 用 paraml 参数 指定 其 阔 值 。 

(2) 对 于 边缘 图 像 中 每 个 白色 的 点 (x0, y0)， 计 算 其 局 部 梯度 ， 这 里 使 用 Sobel0 进 行 梯度 计 
算 。 假 设 白色 点 为 圆周 上 的 某 点 ， 经 过 (x0, y0) 且 沿 着 梯度 方向 的 直线 将 通过 圆心 。 

(3) 对 于 梯度 直线 上 离 点 (x0, y0) 的 距离 在 minRadius 和 maxRadius 之 间 的 所 有 点 ， 在 累加 
器 中 进行 计数 。 

(4) 累加 器 中 大 于 阔 值 param2 的 局 部 峰值 为 图 像 中 所 检测 出 的 圆 形 的 中 心 。 

(5) 对 于 每 个 检测 出 的 圆心 ， 在 边缘 图 像 中 寻找 离 它 距离 相同 的 白色 点 的 集合 ， 并 计算 出 
半径 。 如 果 此 圆心 有 足够 多 的 白色 点 支持 ， 那 么 它 就 是 一 个 真正 的 圆心 。 


12.4.2 ”图像 分 割 


一 般 的 图 像 颜色 丰富 、 信 息 繁杂 ， 不 利于 计算 机 进行 图 像 识别 。 因 此 通常 会 使 用 图 像 分 割 
技术 ， 将 图 像 中 相似 的 区 域 进行 合并 ， 使 得 图 像 更 容易 理解 和 分 析 。 本 节 将 介绍 OpenCV 中 提 
供 的 3 种 常见 的 图 像 分 割 算 法 。 


1. 图 像 金 字 塔 算法 


所 谓 图 像 金字 塔 , 就 是 将 原始 图 像 按 比例 进行 放大 或 缩小 , 得 到 一 系列 不 同 分 辩 率 的 图 像 。 
pyrSegmentation0 利 用 图 像 金字 塔 ， 先 在 低 分 辩 率 的 图 像 中 进行 图 像 分 割 ， 得 到 一 个 初始 的 分 
割 集合 ， 然 后 随 着 分 辩 率 的 提高 ， 逐 渐 调 整 。 它 的 调用 参数 如 下 : 


pyrSegmentation(src, dst, storage, level, threshold1, threshold2) 


其 中 ，src 参数 是 需要 进行 分 割 处 理 的 图 像 ，dst 参数 是 进行 图 像 分 割 处 理 后 的 结果 。 和 以 
前 介绍 的 图 像 处 理 函数 不 同 ， 这 里 需要 传递 一 个 事先 分 配 好 内 存 的 图 像 对 象 ， 因 此 不 能 使 用 空 
图 像 。storage 参数 是 一 个 MemStorage 对 象 ， 使 用 createMemStorage0 创 建 ， 在 其 中 保存 分 割 之 
后 的 各 个 区 域 的 信息 。 

level 参数 是 一 个 整数 ， 表示 图 像 金字 塔 的 层 数 ， 根据 图 像 大 小 的 不 同 ， 所 能 设置 的 最 大 层 
数 也 会 发 生变 化 。 由 于 金字 塔 两 层 之 间 的 大 小 比例 为 2， 因 此 pyrSegmentation0 只 能 处 理 宽 和 
高 为 2 的 整数 倍 的 图 像 。 如 果 图 像 尺寸 不 符合 此 条 件 ， 可 以 事先 对 图 像 进行 缩放 或 裁剪。 

thresholdl 和 threshold2 参数 是 两 个 用 来 控制 区 域 合 并 的 阔 值 , 当 两 个 像素 或 区 域 的 颜色 差 
别 小 于 阔 值 时 将 进行 合并 ， 关 于 其 具体 含义 请 读者 参考 API 文档 。pyrSegmentation0 返 回 一 个 
CvSeq 对 象 ， 保 存 各 个 分 割 区 域 的 信息 。 目 前 的 PyOpenCYV 版 本 还 没有 提供 方法 来 获取 其 中 的 
内 容 。 

下 面 的 程序 演示 了 threshold2 参数 对 图 像 分 割 结果 的 影响 ， 效 果 如 图 12-18 所 示 。 可 以 看 
到 : 闵 值 越 大 ， 越 多 的 像素 将 被 合并 为 同一 种 颜色 ( 见 文 前 彩 插 )。 


opencv_pyrSegmentation.py 
< 用 pyrSegmentation0) 进 行 图 像 分 割 


图 12-18 用 pyrSegmentation0 进 行 图 像 分 割 ， 从 左 到 右 的 阔 值 分 别 为 10、30、60 


img = cv.imread("fruits.jpg") 
threshold2 = [16，36，66] 
for i, th2 in enumerate(threshold2): 
img2 = img.clone() 
storage = cv.createMemStorage(6) 
result = cv.pyrSegmentation(img, img2, storage, 4, 200, th2) 
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这 里 通过 img.clone0 快 速 获得 一 个 和 img 的 大 小 和 像素 类 型 完全 相同 的 图 像 img2, 其 中 的 
颜色 信息 不 会 被 使 用 。 


2. Mean-Shift 算法 
pyrMeanShiftFiltering0 使 用 Mean-Shift 算法 对 图 像 进行 分 割 ， 它 的 调用 参数 如 下 : 


pyrMeanShiftFiltering(src, dst, sp, sr, max_level=1, 
termcrit=TermCriteria(type=3, maxCount=5, epsilon=1.8)) 


其 中 ，sre 参数 是 原始 图 像 ，dst 参数 是 目标 图 像 。 和 pyrSegmentation0 一 样 ，dst 必须 是 一 
个 已 经 分 配 好 内 存 的 图 像 ， 其 大 小 和 像素 类 型 和 src 一 致 。 

pyrMeanShiftFiltering0 以 src 中 的 每 个 点 (x,y) 为 初始 点 ,寻找 与 它 邻 近 的 点 。 这 里 的 邻近 点 
必须 满足 下 面 两 个 条 件 : 

e 在 以 (x,y) 为 中 心 的 边 长 为 2*sp 的 正方 形 范围 内 。 

e 和 点 (x,y) 的 各 个 通道 值 的 差 的 平方 和 小 于 sr 参数 ， 也 就 是 将 3 个 颜色 通道 当做 三 维 

向 量 ， 在 此 颜色 空间 中 ， 两 个 点 的 距离 小 于 sr。 

然后 计算 邻近 点 的 坐标 平均 值 和 颜色 平均 值 ， 并 据 此 平均 点 再 次 寻找 图 像 中 的 邻近 点 。 如 
此 迭代 下 去 , 直到 满足 迭代 终止 条 件 。 将 迭代 终止 时 的 颜色 平均 值 写 进 图 像 dst 中 的 坐标 点 (x,y)。 

在 OpenCV 中 , 所 有 的 迭代 算法 都 可 以 用 TermCriteria 对 象 设置 迭代 相关 的 参数 。 TermCriteria 
对 象 有 三 个 属性 : maxCount 为 最 大 迭代 次 数 ，epsilon 为 迭代 终止 时 的 误差 ， 即 两 次 迭代 结果 
的 差 小 于 此 值 时 将 结束 计算 ; type 指定 哪 种 终止 条 件 有 效 ，3 表示 两 种 终止 条 件 都 有 效 。 

可 以 通过 max_level 参数 指定 使 用 图 像 金 字 塔 进行 计算 。 当 使 用 图 像 金字 塔 时 ， 它 先 对 低 
分 辨 率 的 图 像 进行 分 割 计 算 ， 然 后 利用 此 结果 对 高 分 辩 率 的 图 像 进 行 分 割 。 

下 面 是 使 用 pyrMeanShiftFiltering0 进 行 图 像 分 割 的 演示 程序 。 由 于 程序 比较 简单 ， 为 了 节 
省 篇 幅 ， 这 里 就 不 列 出 源 代码 了 ， 效 果 如 图 12-19 所 示 ( 见 文 前 彩 插 )。 


可 A opencv_pyrMeanShiftFiltering.py, opencv_pyrMeanShiftFiltering demo.py 
全 于 使 用 pyrMeanShiftFiltering0 进 行 图 像 分 割 | 


图 12-19 使 用 pyrMeanShifiFilteringO 进 行 图 像 分 割 ， 从 左 到 右 参数 sr 分 别 为 20、40、80 


3. 分 水 岭 算 法 


分 水 岭 (Watershed) 算 法 的 基本 思想 是 将 图 像 的 梯度 当 作 一 个 地 形 图 。 图像 中 变化 小 的 区 域 
相当 于 地 形 图 中 的 山谷 ， 而 变化 大 的 区 域 相 当 于 山峰 。 从 指定 的 几 个 初始 区 域 同时 开始 向 地 形 
灌 不 同 颜色 的 水 >， 水 面 上 升 逐 渐 淹 没 山谷 ， 并 且 范 围 逐渐 扩大 。 当 所 有 区 域 的 水 面 连接 到 一 
起 时 ， 所 得 到 的 不 同 颜色 的 灌溉 区 域 就 是 最 终 的 图 像 分 割 结果 ， 最 终 的 分 割 区 域 数 和 初始 区 域 
数 相 同 。 

在 OpenCV 中 ， 使 用 watershed0 实 现 此 算法 ， 它 的 调用 形式 如 下 : 


watershed(image, markers) 


image 参数 是 需要 进行 分 割 处 理 的 图 像 ， 它 必须 是 一 个 3 通道 的 8 位 图 像 。markers 参数 是 
一 个 单 通道 的 32 位 浮 点 数 图 像 ， 其 大 小 必须 和 image 相同 。markers 中 值 大 于 0 的 点 构成 初始 
灌溉 区 域 ， 其 值 可 以 理解 为 水 的 颜色 。 调 用 watershed0 之 后 ，markers 中 几乎 所 有 的 点 都 将 被 
赋值 为 某 个 初始 区 域 的 值 ， 而 在 两 个 区 域 边 界线 上 的 点 将 被 赋值 为 -1。 

我 们 使 用 下 面 的 交互 式 演示 程序 帮助 用 户 观 察 初始 区 域 和 最 终 分 割 结果 之 间 的 关系 。 执行 
此 程序 之 后 ， 将 显示 一 幅 水 果 照 片 。 用 鼠标 左 键 在 图 像 上 绘制 初始 区 域 ， 每 次 都 将 使 用 不 同 颜 
色 。 每 次 松 开 左 键 时 ， 将 使 用 目前 的 初始 区 域 进行 图 像 分 割 ， 并 用 颜色 显示 分 割 之 后 的 各 个 区 
域 ， 效 果 如 图 12-20 所 示 ( 见 文 前 彩 插 )。 当 有 两 个 初始 区 域 时 ， 整 个 图 像 被 分 割 为 两 块 : 绿色 
标 出 的 猕猴 桃 区域 和 所 有 其 他 的 区 域 。 当 我 们 逐渐 增加 初始 区 域 时 ， 图 像 中 各 个 水 果 的 边线 逐 
渐 被 寻找 出 来 。 


a opencv_watershed_demo.py 
用 watershed0 进 行 图 像 分 割 | 


12-20 ”watershed0 的 图 像 分 割 结果 ， 从 左 往 右 逐 步 添加 新 的 初始 区 域 


下 面 分 析 一 下 程序 : 
# 区 域 的 颜色 列表 


marks_color = [© 
cv.CV_RGB(9，6，6) ,cv.CV_RGB(255, 6, 0), 
cv.CV_RGB(9，255，6) ,cv.CV_RGB(0, 8, 255), 


@ 这 里 所 说 的 “颜色 ”是 用 来 区 分 不 同 区 域 的 一 个 数值 ， 和 图 像 的 颜色 没有 任何 关系 。 
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cv.CV_RGB(255，255，6) ,cv.CV_RGB(8，255，255)， 
Cv.CV_RGB(255, 0, 255),cv.CV_RGB(255, 255, 255) 
] 


# 将 颜色 列表 转换 为 调 色 板 数组 ， 只 取 前 3 个 通道 的 值 
palette = np.array([c.ndarray[:-1] for c in marks_color]，dtype=np.uint8) © 


seed = 1 # 从 序号 1 开始 设置 区 域 颜色 
mask_opacity = 8.5 # 绘制 区 域 颜色 的 透明 度 


@ 首 先 ,列表 marks_color 定义 了 各 个 区 域 的 颜色 ,颜色 的 下 标 用 于 设置 markers 数组 ， 而 
颜色 的 值 将 用 于 绘制 的 效果 图 。 注 意 ， 这 里 的 第 一 个 黑色 不 起 作用 ， 因 为 我 们 将 从 1 开始 设置 
markers 数组 。 @ 将 颜色 列表 转换 成 一 个 二 维 数组 palette， 此 数组 在 将 分 割 区 域 转换 回 图 像 时 作 
为 调 色 板 使 用 。 注 意 ， 我 们 只 使 用 前 3 个 通道 的 值 ， 因 此 palette 数组 的 形状 为 (8, 3)。 


img = cv.imread("fruits.jpg") 

img2 = img.clone() # 绘制 初始 区 域 用 

markers = cv.Mat(img2.size()，cv.CV_32S) # 存储 初始 区 域 的 数组 
markers[:] = 9 

cv.namedWindow("Watershed Demo") 

cv.imshow("Watershed Demo", img2) 
cv.setMouseCallback("Watershed Demo", mouse_call back) © 
cv.waitKey(0) 


首先 载 入 图 像 , 并且 复 制 一 份 为 img2, 它 将 被 用 于 绘制 初始 区 域 。 然后 创建 markers 数组 ， 
并 将 其 初始 化 为 0。@ 为 了 处 理 鼠 标 事 件 ， 我 们 使 用 setMouseCallback0 将 mouse_call backO 函 
数 设 置 为 窗口 "Watershed Demo" 的 鼠标 事件 处 理 函 数 。 在 窗口 中 发 生 的 任何 鼠标 事件 都 将 调用 
mouse_call_back0 进 行 处 理 。 


def mouse_call back(event, x, y, flags, user_data): 
global seed 


# 右键 松 开 时 ， 初 始 化 种 子 图 像 
if event == cv.CV_EVENT_RBUTTONUP: @ 


ing2[:] = ing[:] 
markers[:] = 8 
seed = 1 


Cv.imshow("Watershed Demo", img2) 
if seed == len(marks_color): return 


# 左 键 按 下 时 ， 在 种 子 图 像 上 添加 种 子 
if flags == cv.CV_EVENT_FLAG_LBUTTON: © 
pt = cv.Point(x, y) 


cv.circle(markers, pt, 5, cv.Scalar(seed, seed, seed,seed), cv.CV_FILLED) 
cv.circle(img2, pt, 5, marks_color[seed], cv.CV_FILLED) 
Cv.imshow("Watershed Demo", img2) 


# 左 键 松 开 时 ， 使 用 watershed 进行 图 像 分 割 
if event == cv.CV_EVENT_LBUTTONUP: 
seed += 1 
tmp_markers = markers.clone() @ 
cv.watershed(img, tmp_markers) 
color map = tmp_markers[:].astype(np.int) @ 


img3 = img2.clone() 

img4 = cv.asMat( palette[color map] ) @ 
cv.addWeighted(img3, 1.0, img4, mask_opacity, 8, img3) © 
cv.imshow("Watershed Demo", img3) 


鼠标 事件 处 理 函 数 的 参数 列表 如 下 : 


mouse_call back(event, x, y, flags, user_data) 


其 中 ，event 参数 为 发 生 的 鼠标 事件 ，x 和 y 参数 为 此 时 鼠标 的 坐标 ，flags 参数 是 鼠标 的 
按键 状态 。@ 当 event 为 CV_EVENT_RBUTTONUP, 即 释放 右键 时 , 我 们 初始 化 img2、markers 
和 seed 等 ， 并 且 刷 新 显示 。@@ 当 鼠标 左 键 为 按 下 状态 时 ， 以 5 个 像素 为 半径 分 别 在 markers 和 
img2 上 绘制 填充 圆 。 在 markers 上 用 seed 作为 颜色 ， 在 img2 上 用 seed 对 应 的 颜色 绘图 。 


当 处 理 OpenCV 图 像 窗口 的 鼠标 事件 时 ， 需 要 执行 waitKey0 函 数 。 此 时 无 法 在 同一 
个 线程 中 同时 运行 TraitsUI 界面 。 


当 鼠 标 左 键 松 开 时 ,调用 watershed(O) 进 行 图 像 分 割 ,并 绘制 分 割 的 结果 .@ 为 了 保证 markers 
中 的 内 容 不 被 覆盖 , 我 们 将 它 的 复 本 tmp_markers 传递 给 watershed0。 分 割 完成 之 后 , tmp_markers 
中 将 保存 图 像 分 割 的 结果 。@ 由 于 它 的 元 素 为 浮 点 数 ， 因 此 先 将 其 转换 为 整数 数组 color map， 
color map 中 的 元 素 值 为 颜色 的 下 标 .@ 使 用 前 面 创建 的 调 色 板 数组 palette 将 color_ map 转换 成 
一 个 3 通道 的 图 像 img4。@ 最 后 将 img4 以 半 透 明 的 方式 县 加 到 img2 的 复 本 img3 上 。 这 里 使 
用 addWeighted0 进 行 合 加 计算 ， 其 调用 参数 如 下 : 


addweighted( a, alpha, b, beta, gamma, c¢) 


其 中 ，a、b、c 是 3 个 大 小 和 通道 数 都 相同 的 数组 ，alpha、beta 和 gamma 是 3 个 浮 点 数 ， 
addWeightedO 完 成 如 下 计算 ， 其 中 的 I 表示 多 维 下 标 : 


c[I] = a[I] * alpha + b[I] * beta + gamma 
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也 可 以 使 用 Numpy 进行 同样 的 计算 ， 但 是 addWeighted0 的 好 处 在 于 它 使 用 饱和 加 法 ， 当 
结果 超出 c 的 数值 范围 时 将 不 会 出 现 翻转 问题 。 例 如 , 某 点 的 计算 结果 为 257, 如 果 使 用 NumPy 
计算 ,会 将 1 保存 到 c， 而 如 果 使 用 addWeighted0， 会 对 257 进行 饱和 处 理 ， 将 数值 范围 的 最 
大 值 255 保存 到 c 中 。 


12.4.3 用 SURF 进行 特征 匹配 


SURF "是 一 种 快速 提取 图 像 的 特征 点 的 算法 , 它 所 提取 的 图 像 特征 具有 缩放 和 旋转 的 不 变 
性 ， 而 且 它 对 图 像 的 灰 度 变化 也 不 敏感 。 针 对 SURF 算法 的 详细 介绍 已 超出 本 书 的 范围 ， 本 节 
只 简单 地 介绍 OpenCV 中 SURF 类 的 用 法 。 下 面 的 程序 演示 了 如 何在 一 幅 图 及 其 仿 射 变换 结果 
图 之 间 寻 找 匹 配 的 特征 点 ， 运 行 效果 如 图 12-21 所 示 。 


和 A ‘opencv_surf demo.py 
汛 用 SURF 寻找 图 像 之 间 匹 配 的 特征 点 


main inin 一 Joanoroon 
ES 
WM 1 
她 昌 随 证 各 万 


图 12-21 用 SURF 寻找 图 像 之 间 匹 配 的 特征 点 


界面 中 ， 通 过 “变换 矩阵 ”设置 仿 射 变换 矩阵 ， 而 “hessian 阔 值 ”、“Octaves” 和 “ 层 数 ” 
则 是 SURF 算法 的 3 个 参数 。 使 用 SURF 得 到 的 特征 包括 两 个 部 分 : 描述 特征 位 置 、 尺 寸 和 方 
向 的 特征 点 对 象 ， 以 及 描述 特征 样式 的 特征 向 量 。 如 果 在 界面 中 选中 了 “绘制 特征 点 ” 复 选 框 ， 
在 图 像 上 将 用 圆 形 表示 出 特征 点 的 位 置 和 尺寸 。 每 个 特征 点 都 有 一 个 特征 向 量 与 其 对 应 ,通过 
计算 两 幅 图 的 两 组 特征 点 之 间 所 有 特征 向 量 的 距离 ， 可 以 找 出 特征 相似 的 两 组 特征 点 。 程 序 中 
用 直线 连接 所 有 特征 向 量 距离 小 于 “距离 阔 值 ”的 特征 点 。 由 于 程序 较 长 ， 这 里 只 对 程序 中 与 
特征 点 提取 相关 的 部 分 进行 说 明 : 


def get features(self, img): 


@ 英文 全 称 为 Speeded-Up Robust Features。 


surf = cv.SURF(self.hessian th, self.octaves, self.layers, True) @ 
keypoints = cv.vector KeyPoint() 

features = surf(img, cv.Mat(), keypoints) 加 

return keypoints, np.array(features) 


首先 ，get_features0 通 过 调用 SURFO 寻 找 出 图 像 的 特征 点 。@SURF 是 一 个 类 ， 它 的 初始 
化 方法 中 有 4 个 参数 : 


SURF._ init (self, _hessianThreshold , nOctaves, _nOctaveLayers, _extended=False) 


其 中 ， 前 3 个 参数 分 别 与 界面 中 的 “hessian 阔 值 ”、“Octaves” 和 “ 层 数 ”相对 应 ， 请 读 
者 在 演示 界面 中 调节 这 些 参数 以 了 解 它们 是 如 何 影响 所 提取 的 特征 点 的 参数 extended 决定 了 
每 个 特征 点 的 特征 向 量 的 长 度 ，False 表示 向 量 长 度 为 64，True 表示 向 量 长 度 为 128。 

直接 调用 SURF 对 象 ， 即 可 对 图 像 进行 特征 点 提取 ， 它 有 两 种 调用 方式 : 


SURF._call_(self, img, mask) 


img 参数 是 要 提取 特征 点 的 图 像 ， 通 过 mask 参数 可 以 指定 img 的 遮 四 图 像 。 它 返回 的 是 
一 个 KeyPoint 对 象 的 列表 , 图像 中 每 个 特征 点 都 由 KeyPoint 对 象 进行 描述 .读者 可 以 在 Python 
中 输入 “cvKeyPoint?” 来 查看 它 的 文档 说 明 。 其 中 保存 了 特征 点 的 位 置 、 大 小 及 方向 等 信息 。 
此 方法 只 能 获得 图 像 的 特征 点 列表 ， 而 不 能 获得 每 个 特征 点 的 特征 向 量 。 下 面 的 调用 方法 则 可 
以 同时 获得 特征 点 和 特征 向 量 : 


SURF._call_(self, img, mask, keypoints, useProvidedKeypoints=False) 


它 返 回 的 是 一 个 1 行 N 列 的 单 精度 浮 点 数 数组 , 我 们 可 以 把 它 看 做 一 维 数 组 。 其 中 顺序 存 
储 着 与 特征 点 列表 中 每 个 特征 点 对 应 的 特征 向 量 。 当 useProvidedKeypoints 参数 为 False 时 , 它 
会 将 特征 点 都 添加 到 keypoints 列表 中 。@ 程 序 中 使 用 这 种 调用 方式 同时 获得 特征 点 和 特征 矢量 。 

对 两 幅 图 进行 特征 提取 之 后 ， 它 们 的 特征 点 和 特征 向 量 分 别 保存 在 keypoints1、features1、 
keypoints2、features2 等 几 个 属性 中 。 下 面 的 代码 计算 featuresl 和 features2 之 间 的 距离 : 


def match_features(self) : 
fl1 = self.features1.reshape(len(self.keypoints1), -1) © 
f2 = self.features2.reshape(len(self.keypoints2), -1) 
self.f1= f1 
self.f2 = f2 
distances = cdist(f1, f2) @ 
self.mindist = np.min(distances, axis=1) © 
self.idx mindist = np.argmin(distances, axis=1) 


人 @ 调 用 reshape0 方 法 将 特征 向 量 转换 成 二 维 数组 。 它 的 第 0 轴 的 长 度 为 特征 点 的 个 数 ， 第 
1 轴 的 长 度 为 特征 向 量 的 长 度 。@ 然 后 调用 cdist0 计 算出 距离 矩阵 distances，cdist0 是 SciPy 中 
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的 一 个 特殊 函数 ， 因 此 在 程序 开头 使 用 下 面 的 语句 载 入 它 : 


from scipy.spatial.distance import cdist 


使 用 edistGf, 包 ) 可 以 快速 计算 输入 的 两 组 向 量 身 和 也 中 所 有 两 对 向 量 之 间 的 距离 ， 它 返 
回 一 个 形状 为 (和 1.shape[0], 亿 .shape[0]) 的 二 维 数组 ， 其 中 每 个 值 是 与 其 对 应 的 两 个 向 量 的 距离 。 
由 于 所 有 的 计算 都 在 C 语言 级 别 完成 ， 因 此 运算 速度 很 快 。 它 相当 于 使 用 NumPy 进行 了 如 下 
计算 ”: 
distances[i, j] = np.sqrt(np.sum((fl[i] - f2[j])**2)) 


@ 接 下 来 找 出 distances 中 每 行 的 最 小 值 以 及 最 小 值 的 下 标 ， 分 别 保 存 为 mindist 和 
idx_mindist 属性 。 于 是 ，idx_mindist[j] 就 是 也 中 与 所] 距离 最 近 的 向 量 的 下 标 。 
最 后 , 在 redraw0 方 法 中 使 用 下 面 的 语句 , 用 直线 连接 两 幅 图 像 中 距离 小 于 阔 值 的 特征 点 : 


# 绘制 直线 ， 连 接 距离 小 于 阔 值 的 两 个 特征 点 
for idx1 in np.where(self.mindist < self.max distance)[6]: © 
idx2 = self.idx mindist[idx1] 
posl = self.keypoints1[int(idx1)].pt ©@ 
pos2 = self.keypoints2[int(idx2)] .pt 
pl = cv.Point(int(pos1.x), int(pos1.y)) © 
p2 = cv.Point(int(pos2.x)+w, int(pos2.y)) 
cv.line(show_img, pl, p2, cv.CV_RGB(8,255,255), lineType=16) 


@ 用 where0 找 到 mindist 中 小 于 指定 阔 值 的 下 标 。.@ 对 这 些 下 标 进行 循环 ,通过 idx_mindist 
获得 右 图 中 (参见 图 12-21) 与 其 距离 最 近 的 特征 点 的 下 标 ， 然 后 通过 KeyPoint 对 象 的 pt 属性 获 
得 特征 点 的 位 置信 息 。@ 最 后 将 位 置 转换 为 Point 对 象 ， 用 来 绘制 线段 。 为 了 让 线段 的 右 端点 
和 右 图 中 的 特征 点 重合 ， 需 要 对 右 图 特征 点 的 横 坐 标 加 上 左 图 的 宽度 w。 


图 实际 上 ， 如 果 想 用 NumPy 快速 计算 此 距离 矩阵 ， 可 以 通过 广播 运算 ， 在 Python 级 别 只 使 用 一 层 循环 实现 。 


数据 和 文件 


有 了 数据 才能 够 处 理 ， 因 此 让 我 们 首先 了 解 如 何 利用 Python 的 扩展 库 读 写 各 种 各 样 的 数 
据 。 本 章 介绍 如 何 处 理 声音 、 动 画 、Excel 和 HDF5 等 多 种 格式 的 文件 ， 以 及 如 何 从 声卡 、 摄 
像 头 等 设备 实时 读 取 数 据 。 


13.1 声音 的 输入 输出 


标准 的 Python 库 支 持 WAV 文件 的 读 写 ， 而 实时 的 声音 输入 输出 则 需要 安装 pyAudio 模 
块 。 掌 握 了 这 些 基础 知识 之 后 ， 就 可 以 做 许多 有 趣 的 声效 处 理 实验 了 。 声 效 处 理 方面 的 内 容 将 
在 以 后 的 章节 介绍 。 


13.1.1 读 写 WAV 文件 


WAYV 是 微软 公司 开发 的 一 种 声音 文件 格式 ， 虽 然 支 持 多 种 压缩 格式 ， 但 它 却 经 常 被 用 来 
保存 未 压缩 的 声音 数据 。WAV 文件 有 3 个 重要 的 参数 : 声 道 数 、 取 样 频率 和 量化 位 数 。 

。 声 道 数 ， 可 以 是 单 声 道 或 双 声 道 。 

e 采样 频率 : 一 秒 内 对 声音 信号 的 采集 次 数 , 常用 的 有 8k Hz、 16k Hz、 32k Hz、 48k Hz、 

11.025k Hz、 22.05k Hz、 44.1k Hz。 

e 量化 位 数 : 一 次 采样 所 采集 数据 的 比特 数 , 通常 有 8 bit、16 bit、24 bit 和 32 bit 等 几 种 。 

如 果 读 者 需要 自己 录制 和 编辑 声音 文件 ， 推 荐 使 用 Audacity， 它 是 一 款 开源 、 跨 平台 、 多 
声 道 的 录音 编辑 软件 。 可 以 用 它 进行 声音 信号 的 录制 ， 然 后 再 输出 为 WAV 文件 供 Python 程序 
处 理 。 


http://audacity.sourceforge.net 
开源 录音 编辑 软件 Audacity 的 下 载 地 址 
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下 面 让 我 们 看 看 如 何在 Python 中 读 写 声音 文件 , 下 面 的 程序 可 绘制 如 图 13-1 所 示 的 Windows 
XP 的 警告 声波 形 : 


# read Wave.py 
下 


半生 读 取 WAV 文件 并 绘制 波形 
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import wave 
import pylab as pl 
import numpy as np 


# 读 取 格式 和 数据 

f = wave.open(r"c:\WINDOWS\Media\ding.wav", "rb") © 
nchannels, sampwidth, framerate, nframes = f.getparams()[:4] ©@ 
str_data = f.readframes(nframes) © 

f.close() 


# 将 波形 数据 转换 为 数组 

wave_data = np.fromstring(str_data, dtype=np.short) @ 
wave_data.shape = -1，nchannels @ 

time = np.arange(9，nframes) * (1.6 / framerate) © 


# 绘制 波形 

pl.subplot(211) 

pl.plot(time, wave_data[:,8]) 
pl.subplot(212) 

pl.plot(time, wave_data[:,1], c="g") 
pl.xlabel("time (seconds)") 
pl.show() 
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图 13-1 Windows XP 的 经 典 “ 叮 ” 声 的 波形 


首先 载 入 处 理 WAYV 文件 的 标准 模块 wave，@ 然 后 调用 wave.open0 打 开 WAYV 文件 ， 注 
意 需要 使 用 二 进 制 模式 "rb" 打 开 文 件 。open0 返 回 一 个 Wave _read 对 象 , 通过 它 的 方法 可 以 读 取 
WAV 文件 的 格式 和 数据 。 

@ 调 用 getparams0 读 取 WAYV 文件 的 所 有 格式 信息 ， 它 返回 的 是 一 个 元 组 ， 其 中 的 每 个 元 
素 分 别 表示 声 道 数 、 以 字 节 为 单位 的 量化 位 数 、 采 样 频率 、 采 样 点 数 、 压 缩 类 型 、 压 缩 类 型 的 
描述 。wave 模块 只 支持 未 压缩 的 声音 数据 ， 因 此 可 以 忽略 最 后 两 个 格式 信息 。 这 些 信息 也 可 


以 分 别 用 getnchannels0、getsampwidthO0、getframerate0、getnframes0 获 得 。 

全 调用 readframes0 读 取 声 音 数据 , 其 参数 为 需要 读 取 的 取样 点 数 , 这 里 传递 整个 文件 的 采 
样 点 数 nframes， 表 示 读 入 整个 WAV 文件 的 数据 。readframes0 返 回 用 字符 串 表示 的 二 进 制 
数据 。 

@ 接 下 来 需要 根据 声 道 数 和 量化 单位 ， 将 读 取 的 二 进 制 数据 转换 为 NumPy 数组 。 调 用 
fromstring0 将 字符 串 转 换 为 数组 ，dtype 参数 指定 数组 的 数据 类 型 。 由 于 我 们 的 声音 格式 是 以 两 
个 字 节 表示 一 个 取样 值 ， 为 了 方便 起 见 ， 这 里 直接 设置 dtype 参数 为 short 类 型 。 更 完美 的 实现 
需要 根据 量化 位 数 sampwidth 选择 合适 的 数据 类 型 。 

现在 得 到 的 wave_data 是 一 个 一 维 短 整 型 数组 ， 但 我 们 的 声音 文件 是 双 声 道 的 ， 它 由 左右 
两 个 声 道 的 取样 交替 构成 。 因 此 @ 设 置 wave_data 数组 的 shape 属性 ， 修 改 其 形状 ， 这 样 一 来 ， 
数组 的 第 0 轴 的 长 度 为 取样 点 数 ， 第 1 轴 的 长 度 为 声 道 数 。 

@ 为 了 绘图 方便 ， 通 过 取样 点 数 和 取样 频率 计算 出 每 个 取样 的 时 刻 。 

上 面 的 程序 是 将 WAV 文件 中 的 数据 一 次 性 全 部 读 入 内 存 。 如 果 希 望 读 取 声 音 文件 中 的 某 
一 段 数据 ， 可 以 先 调用 wave_read 对 象 的 setpos(pos) 方 法 ， 将 文件 指针 移动 到 指定 位 置 ， 其 中 
的 pos 参数 是 跳 过 的 取样 点 数 。 然 后 再 调用 readframes0 读 取 指 定 长 度 的 声音 数据 。 

写 WAV 文件 的 方法 和 读 类 似 ， 下 面 的 程序 将 频率 扫描 波 写 入 WAYV 文件 : 


a write_wave.py 


将 频率 扫描 波 写 入 WAV 文件 


import wave 
import numpy as np 
import scipy.signal as signal 


framerate = 44166 
time = 19 


# 产生 19 秒 44.1 kHz 的 198 Hz-1 kHz 的 频率 扫描 波 

t = np.arange(0, time, 1.0/framerate) 

wave_data = signal.chirp(t，166，time，1666，method='linear') * 10000 © 
wave_data = wave_data.astype(np.short) 


# 打开 WAV 文档 


f = wave.open(r"sweep.wav"，"wb") 


# 配置 声 道 数 、 量 化 位 数 和 取样 频率 
f.setnchannels(1) @ 

和 .setsampwidth(2) 
f.setframerate(framerate) 

# 将 wav_data 转换 为 二 进 制 数据 写 入 文件 
f.writeframes(wave_data.tostring()) © 
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f.close() 


@ 调 用 SciPy 的 signal 模块 中 的 chrip0， 产 生长 度 为 10 秒 、 取 样 频率 为 44.1 kHz、100 Hz 
到 1 kHz 的 频率 扫描 波 。 由 于 chrip0 返 回 的 数组 为 浮 点 数 类 型 , 因此 调用 数组 的 astype0 将 其 转 
换 为 短 整 型 数组 。 

用 "wb" 模 式 打 开 WAYV 文件 之 后 , @ 分 别 调用 setnchannels( 〇 、setsampwidth()、setframerate() 
方法 设置 WAV 文件 的 声 道 数 、 量 化 位 数 、 取 样 频率 。 也 可 以 调用 setparams0 一 次 配置 所 有 参 
数 。 最 后 @ 调 用 writeframes0 方 法 ， 将 数组 的 二 进 制 数 据 写 入 文件 。 

用 Python 的 标准 模块 读 写 WAYV 文件 时 ， 需 要 调用 NumpPy 的 相关 函数 将 字 节 数据 转换 为 
真正 的 声音 数据 。SciPy 提供 了 快速 读 写 WAV 文件 的 函数 ， 能 直接 返回 数组 。 下 面 的 语句 读 
取 Windows XP 的 警告 声 文件 ，read0 返 回 两 个 值 一 一 取样 频率 和 表示 声音 数据 的 数组 : 


>>> import scipy.io.wavfile as wavfile 

>>> rate，data = wavfile.read(r"c:\WINDOWS\Media\ding.wav") 
>>> rate 

22656 

>>> data.shape 

(26191，2) 

>>> data.dtype 

dtype('int16') 


由 上 面 的 结果 可 知 ，“ding.wav” 的 取样 频率 为 22050 Hz， 而 声音 数据 有 两 个 声 道 、20191 
个 取样 值 ， 每 个 取样 值 都 用 短 整 型 数 表示 。 下 面 的 语句 将 声音 数据 倒转 ， 然 后 写 入 
“Teverse ding.wav” 文 件 : 


>>> wavfile.write("reverse_ding.wav"，rate，data[::-1，:]) 


虽然 用 wavfile 模块 能 快速 读 写 声音 文件 ， 但 是 它 会 一 次 将 所 有 的 数据 都 读 入 内 存 ， 因 此 
不 适合 处 理 很 大 的 WAV 文件 。 用 前 面 介绍 的 方法 可 以 分 段 读 取 声 音信 号 数据 , 便于 程序 处 理 。 


13.1.2 用 pyAudio 播放 和 录音 


使 用 pyAudio 模块 可 以 直接 利用 声卡 实时 地 进行 声音 数据 的 输入 和 输出 。 

pyAudio 模块 对 开源 声音 库 PortAudio 的 一 些 常用 功能 进行 了 简单 封装 ， 目 前 它 只 支持 阻 
塞 式 的 输入 输出 模式 。 所 谓 阻塞 模式 ， 是 指 需要 用 户 程序 主动 读 写 输入 输出 流 。 虽 然 阻塞 模式 
在 功能 上 有 一 定局 限 ， 但 是 由 于 编程 比较 简单 ， 因 而 非常 适合 编写 处 理 声 音 的 脚本 程序 。 


© http://people.csail.mit.edu/hubert/pyaudio 
pyAudio 模块 的 下 载 地 址 


下 面 先 看 看 如 何 播放 声音 : 


5 pyaudio playpy 
全 用 pyAudio 播 放 WAV 文件 


import pyaudio 

import wave 

chunk = 1624 

wf = wave.open(r"c:\WINDOWS\Media\ding.wav", 'rb') 

p= pyaudio.PyAudio() © 

# 打开 声音 输出 流 

stream = p.open(format = p.get_ format from width(wf.getsampwidth()), © 
channels = wf.getnchannels(), 
rate = wf.getframerate(), 
output = True) 


# 写 声音 输出 流 到 声卡 进行 播放 

while True: 
data = wf.readframes(chunk) © 
if data == "": break 
stream.write(data) @ 


stream.close() 
p.terminate() 


@ 首 先 创 建 一 个 PyAudio 对 象 ， 然 后 @ 调 用 其 open() 方 法 获得 声卡 的 声音 输出 流 ， 这 里 根 
据 WAYV 文件 的 量化 格式 、 声 道 数 和 取样 频率 ， 分 别 配 置 open0 的 各 个 参数 。 然 后 @ 循 环 地 从 
WAYV 文件 读 取 数据 ，@ 并 调用 声音 输出 流 的 write( 方 法 将 读 取 的 数据 输出 到 声卡 。 在 循环 体 
中 没有 任何 等 待 的 代码 ， 因 为 pyAudio 使 用 阻塞 模式 ， 因 此 当 底层 的 输出 数据 缓存 区 没有 空间 
保存 数据 时 , “stream .write(data)” 会 阻塞 用 户 程序 ， 直 到 有 足够 空间 容纳 新 的 数据 为 止 。 

下 面 列 出 PyAudio 对 象 的 open0 方 法 的 参数 : 

e rate: 声音 流 的 取样 频率 。 

e channels: 声音 流 的 声 道 数 。 

e ”format: 取样 值 的 量化 格式 ， 值 可 以 为 paFloat32、palInt32、paInt24、palInt16、paInt8 
等 。 在 本 例 中 ， 使 用 get_format from width0 将 wf.getsampwidth0 的 返回 值 2 转换 为 
palnt16。 
input: 输入 流标 志 ，Tme 表示 开启 输入 流 。 
output: 输出 流标 志 ，True 表示 开启 输出 流 。 
input_device_index: 输入 流 所 使 用 的 设备 编号 , 如 果 不 指定 , 将 使 用 系统 的 默认 设备 。 
output_device_index: 输出 流 所 使 用 的 设备 编号 , 如 果 不 指定 , 将 使 用 系统 的 默认 设备 。 
frames_per_buffer: 底层 缓存 区 的 大 小 。 


让 半 汉 汝 嵌 


| 457 


着 半 关 哺 内 


458 


Python 科学 计算 


e start: 是 否 立即 开启 输入 输出 流 ， 默 认 值 为 Tme。 
从 声卡 读数 据 和 写 数据 一 样 简单 ， 下 面 是 一 个 简单 的 检测 声音 的 例子 : 


a pyAudio record.py 
从 声卡 读 取 声 音 数据 


from pyaudio import PyAudio, paInt16 
import numpy as np 

from datetime import datetime 
import wave 


# 将 data 中 的 数据 保存 到 名 为 filename 的 WAV 文件 中 
def save wave file(filename, data): 
wf = wave.open(filename, "wb ') 
wf.setnchannels(1) 
wf.setsampwidth(2) 
wf.setframerate(SAMPLING_RATE) 
wf.writeframes("".join(data)) 
wf.close() 


NUM_SAMPLES = 2666 # pyAudio 内 部 缓存 的 块 的 大 小 @ 
SAMPLING_RATE = 8668 ”# 取样 频率 


LEVEL = 1566 # 声音 保存 的 阔 值 

COUNT_NUM = 29 # NUM_SAMPLES 个 取样 之 内 出 现 COUNT_NUM 个 值 大 于 LEVEL 的 取样 ， 就 记 
录 声 音 

SAVE_LENGTH = 8 # 声音 记录 的 最 小 长 度 : SAVE_LENGTH * NUM_SAMPLES 个 取样 

# 开启 声音 输入 

pa = PyAudio() 


stream = pa.open(format=paInt16, channels=1, rate=SAMPLING RATE, input=True, 
frames_per_buffer=NUM_SAMPLES) 


save_count = 9 
save_buffer = [] 


while True: 
# 读 入 NUM_SAMPLES 个 取样 
string_audio_data = stream.read(NUM SAMPLES) 
# 将 读 入 的 数据 转换 为 数组 
audio data = np.fromstring(string_audio_data，dtype=np.short) ©@ 
# 计算 大 于 LEVEL 的 取样 的 个 数 
large_sample_count = np.sum( audio data > LEVEL ) 
print np.max(audio data) 
# 如 果 个 数 大 于 COUNT_NUM， 至 少 保存 SAVE_LENGTH 个 块 


if large_sample_count > COUNT_NUM: 
save_count = SAVE_LENGTH 

else: 
save_count -= 1 


if save_count < @: 
save_count = @ 


if save_count > @: 
# 将 要 保存 的 数据 存放 到 save_buffer 中 
save_buffer.append( string audio data ) 
else: 
# 将 save_buffer 中 的 数据 写 入 WAV 文件 ，WAV 文件 的 文件 名 是 保存 的 时 间 
if len(save_ buffer) > @: 
filename = datetime.now().strftime("%Y-%m-%d_%H_%M %S") + ".wav" 
save wave file(filename, save_buffer) 
save_buffer = [] 
print filename, "saved” 


@ 程 序 中 用 一 些 全 局 变量 来 配置 录音 参数 : 以 SAMPLING RATE 为 采样 频率 ， 每 次 读 入 
一 块 有 NUM_SAMPLES 个 采样 的 数据 块 , 当 读 入 的 采样 数据 中 有 COUNT NUM 个 值 大 于 LEVEL 
时 ， 将 数据 保存 到 WAYV 文件 中 ,一旦 开始 保存 数据 ， 保 存 的 数据 长 度 最 短 为 SAVE_ LENGTH 个 
块 。WAYV 文件 以 保存 时 的 时 间作 为 文件 名 。 

@ 从 声卡 读 入 的 数据 和 从 WAYV 文件 读 入 的 数据 相同 ， 都 是 二 进 制 数据 。 由 于 使 用 paInt16 
格式 (16 位 的 短 整 型 ) 保 存 采 样 值 ， 因 此 在 将 它 转换 为 数组 时 ， 设 置 dtype 参数 为 np.short。 


13.2 ”视频 的 输入 输出 


13.2.1 ” 读 写 视频 文件 


本 节 介绍 如 何在 Windows 系统 下 使 用 OpenCV 进行 视频 文件 的 读 写 。 虽 然 在 不 同 的 操作 
系统 下 ，OpenCV 读 写 视频 的 内 部 实现 不 同 ， 但 是 它们 的 API 函数 的 用 法 是 相同 的 。 

在 Windows 下 OpenCV 使 用 “Video For Windows”(VFW) 处 理 视频 文件 ， 它 是 一 种 过 时 
的 技术 ， 目 前 已 经 被 DirectShow 取代 , 但 是 由 于 其 用 法 简单 ,用 它 编写 简单 的 视频 处 理 脚本 程 
序 还 是 很 合适 的 。 下 面 我 们 先 看 看 如 何 生成 视频 文件 。 


有 # aviwrite_waterwave.py 
守 志 ”制作 水 波动 画 的 视频 文件 
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import numpy as np 
import pyopencv as cv 


class WaterWave(object): © 
def _init_(self, w, h, N, damping): 

self.width, self.height = w，h 
self.N = N 
self.damping = damping 
self.w1 = np.zeros((self.height, self.width), dtype=np.float) 
self.w2 = np.zeros((self.height, self.width), dtype=np.float) 
self.tmpbuf = np.zeros((self.height-2, self.width-2), dtype=np.float) 
self.bmp = np.zeros((self.height, self.width, 3), dtype=np.uint8) 


h, w = self.height - 2, self.width - 2 
self.slice = [(slice(i,h+i), slice(j,w+j)) 
for i in xrange(3) for j in xrange(3) if i!=1 or j!=1] 


def step(self): 
y = np.random.randint(1, self.height-1, self.N) 
x = np.random.randint(1, self.width-1, self.N) 
self.wl[y, x] = np.random.random(self.N) * 126 + 128 


self.tmpbuf[:] = 9 
for s in self.slice: 
self.tmpbuf += Self.wl[s] 


self.tmpbuf /= 4 

self.w2[1:-1, 1:-1] *= -1 
self.w2[1:-1, 1:-1] += self.tmpbuf 
self.w2 *= self.damping 

self.wl, self.w2 = self.w2, self.wl 


self.bmp[:,:,0] = self.wl + 128 

self.bmp[:,:,1] = self.bmp[:,:,8] - (self.bmp[:,:,0] >> 2) 
self.bmp[:,:,2] = self.bmp[:,:,1] 

return self.bmp 


WIDTH, HEIGHT = 640, 480 
video = cv.VideoWriter() @ 
video.open("waterwave.avi", cv.CV_FOURCC(*"DIB "), 30, cv.Size2i(WIDTH, HEIGHT)) © 
water = WaterWave(WIDTH, HEIGHT, 1006, 8.97) 
import time 
start = time.clock() 
for i in xrange(280): 
if i % 30 == 0: print i 
r = water.step() 


mat = cv.asMat(r) 
video << mat @ 

del video © 

print time.clock() - start 


@WaterWave 类 用 来 模拟 如 图 13-2 所 示 的 水 波 效果 。 其 step0 方 法 返回 一 个 表示 水 波 图 像 
的 Numpy 数组 。 关 于 水 波动 画 的 计算 原理 请 感 兴趣 的 读者 搜索 关键 词 “实现 水 波 的 模拟 ”。 


图 13-2 水 波动 画 的 截图 


@ 我 们 使 用 PyOpenCV 的 VideoWriter 类 将 WaterWave 对 象 的 计算 结果 输出 到 AVI 视 频 文 
件 中 。@VideoWriter 对 象 的 open0 方 法 有 4 个 参数 :视频 文件 名 表示 视频 压缩 格式 的 FOURCC 
参数 、 每 秒 的 帧 数 、 视 频 画面 的 大 小 。 这 里 的 FOURCC 参数 是 一 个 用 CV_FOURCCO 计 算 的 
表示 4 个 字符 的 32 位 整数 , 程序 中 的 "DIB "表示 所 生成 的 视频 不 进行 任何 压缩 , 因此 产生 的 视 
频 文件 会 很 大 。13.3.2 节 将 对 FOURCC 参数 进行 详细 介绍 , 读者 可 以 选择 安装 合适 的 视频 编码 
库 ， 从 而 制作 更 小 的 视频 文件 。 

@ 使 用 左 移 位 运算 符 <<<” 将 表示 图 像 的 Mat 对 象 添加 到 视频 文件 中 , @ 最 后 在 VideoWriter 
对 象 销毁 时 完成 视频 文件 的 输出 。 

由 上 面 的 例子 可 知 ， 只 要 我 们 能 创建 一 系列 表示 图 像 的 数组 ， 就 可 以 用 VideoWriter 对 象 
将 这 些 数组 转换 为 视频 文件 。 由 于 matplotlib 提供 了 访问 图 表 的 图 像 数据 的 方法 ， 因 此 不 需要 
将 图 表 保存 到 临时 的 图 像 文件 中 ， 而 是 可 以 直接 将 图 表 的 内 部 图 像 数据 转 换 成 数组 ， 从 而 快速 
制作 视频 文件 。 下 面 是 一 个 例子 : 


# aviwrite_matplotlib.py 
读 将 matplotlib 绘制 的 心 形 隐 函 数 曲 线 制作 成 动画 


import numpy as np 
import matplotlib.pyplot as plt 
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import pyopencv as cv 


y，x = np.ogrid[-2:2:366j,-2:2:366j] 
Z = (X+#2+y#*#2-1)##+3 - X**2*y**3 


fig = plt.figure(figsize=(4,4)) 
w, h = fig.bbox.width, fig.bbox.height 


video = None 
for level in np.linspace(-8.2,0.2,101): 
fig.clear() © 
axe = fig.add_subplot(111, aspect=1) 
plt.contour(x.ravel(), y.ravel(), z, levels=[level]) 
plt.title("level=%5.3f" % level) 
axe.xaxis.set ticks([]) 
axe.yaxis.set ticks([]) 
fig.canvas.draw() © 
buf = fig.canvas.buffer_rgba(9,6) © 
array = np.frombuffer(buf, np.uint8) @ 
array.shape = h, w, 4 
if not video: 
video = cv.VideoWriter() 
size = cv.Size2i(int(w),int(h)) 
video.open("contour.avi", cv.CV_FOURCC(*"DIB "), 30, size) 
image = cv.Mat(size, cv.CV_8UC3) 
image[:] = array[:,:,2::-1] © 
video << image 
del video 


程序 中 通过 循环 调用 contour0 来 绘制 一 系列 等 值 线 。 为 了 重复 使 用 同一 个 图 表 对 象 fg, © 
每 次 绘图 之 前 用 fig.clear0 将 图 表 内 容 清空 ， 然 后 再 调用 各 种 绘图 函数 进行 绘图 。@ 绘 图 函数 并 
不 会 立即 绘图 ， 因 此 在 保存 数据 之 前 ,需要 调用 图 表 的 canvas 属性 的 draw0 方 法 强制 图 表 进行 
绘图 。 

@canvas 属性 中 保存 有 图 表 的 图 像 数 据 ， 通 过 其 buffer rgba0 方 法 可 以 获得 保存 图 像 数 据 
的 buffer 对 象 ， 它 的 两 个 参数 是 buffer 对 象 在 图 像 数 据 中 的 起 始点 坐标 。 图 像 的 大 小 可 以 通过 
canvas 属性 的 size0 获 得 ， 也 可 以 通过 图 表 对 象 的 bbox 属性 获得 。@ 调 用 fombuffer0 将 buffer 
对 象 转换 为 数组 ， 然 后 对 数组 的 形状 进行 修改 。 数 组 的 第 0 轴 的 长 度 为 图 像 的 高 度 ， 第 1 轴 的 
长 度 为 图 像 的 宽度 ， 第 2 轴 的 长 度 为 图 像 的 通道 数 。 

提 由 于 OpenCV 保存 的 图 像 的 通道 按照 蓝 、 绿 、 红 的 顺序 排列 ， 因 此 需要 对 数组 的 第 2 轴 
进行 反 转 ， 并 且 去 除 alpha 通道 。 

如 果 只 使 用 matplotlib 的 绘图 功能 ， 而 不 需要 显示 任何 绘图 界面 ， 那 么 可 以 在 程序 开头 添 
加 下 面 两 行 代码 ， 让 matplotlib 使 用 不 显示 界面 的 Agg 后 台 绘 图 库 进行 绘制 。 


import matplotlib 
matplotlib.use("Agg') 


13-3 显示 了 从 所 生成 的 视频 文件 中 截取 的 3 帧 图 像 。 


图 13-3 心 形 隐 函 数 曲 线 动画 中 的 3 帧 图 像 


使 用 VideoCapture 对 象 可 以 从 视频 文件 或 视频 设备 (例如 USB 摄像 头 ) 获 取 图 像 ,下面 是 播 
放水 波 视频 文件 的 程序 。 


EE 


从 视频 文件 或 视频 设备 读 取 图 像 数 据 


import pyopencv as cv 


def show video(fileorid): 
cv.namedWindow(str(fileorid), cv.CV_WINDOW_AUTOSIZE) 
video = cv.VideoCapture(fileorid) © 
img = cv.Mat() @ 
while video.grab(): © 
video.retrieve(img, 6) @ 
cv.imshow(str(fileorid), img) 


cv.waitKey(5) 
if _name_ == "_ main_": 
import sys 
try: 


fileorid = sys.argv[1] 
if fileorid.isalnum(): 
fileorid = int(fileorid) 
except: 
fileorid = "waterwave.avi" 
show video(fileorid) 
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@ 首 先 创 建 VideoCapture 对 象 ， 它 的 参数 可 以 是 一 个 表示 视频 文件 名 的 字符 串 ， 也 可 以 是 
一 个 表示 视频 设备 的 整数 。@ 创 建 一 个 空 的 Mat 对 象 ， 以 保存 VideoCapture 对 象 获得 的 图 像 。 
目 调 用 grab0 方 法 捕捉 视 频 中 的 下 一 帧 图 像 ， 如 果 返 回 False， 就 表示 没有 更 多 的 帧 了 。@ 调 用 
Tetrieve( 方 法 将 捕捉 的 图 像 保存 到 img 对 象 中 ， 第 二 个 参数 只 有 在 多 通道 摄像 头 时 才 起 作用 ， 
通常 它 的 值 为 0。 

VideoCapture 对 象 还 提供 了 get0 和 set0 方 法 ， 以 获取 和 设置 一 些 视频 相关 的 属性 。 例 如 : 


>>> import pyopencv as cv 

>>> v = cv.VideoCapture("waterwave.avi") 

>>> v.get(cv.CV_CAP_PROP_FRAME_COUNT) # 获得 视频 的 总 帧 数 
266.6 

>>> v.get(cv.CV_CAP_PROP_FRAME_WIDTH) # 获得 视频 的 宽度 
640.0 


每 个 视频 相关 属性 都 用 一 个 整数 表示 , 在 OpenCV 中 它们 的 预定 义 名 称 都 是 以 “CV_CAP_ 
PROP” 开 头 ,读者 可 以 使 用 IPython 的 自动 补 全 功能 查看 所 有 的 视频 属性 名 。 这 些 属性 有 些 是 
可 以 通过 set0 方 法 进行 设置 的 ， 例 如 : 


>>> v.set(cv.CV_CAP_PROP_POS_FRAMES，186) # 设置 视频 的 当前 帧 为 第 198 帧 


13.2.2 ”安装 视频 编码 


虽然 VFW 是 过 时 的 技术 ， 但 是 很 多 视频 编码 解码 库 仍然 支持 VFW 接口 。 如 果 读 者 的 计 
算 机 上 安装 了 这 些 视频 编码 解码 库 ， 就 可 以 通过 设置 FOURCC 参数 使 用 它们 进行 视频 文件 的 
读 写 。 

读者 可 以 通过 下 面 的 链接 下 载 ffdshow 视频 编码 解码 库 ， 使 用 默认 设置 即 可 安装 “VFW 
接口 ”。 


» http://ffdshow-tryout.sourceforge.net 
支持 VFW 接口 的 视频 编码 解码 库 


每 个 视频 编码 都 可 以 使 用 特定 的 FOURCC 参数 进行 选择 ， 如 果 无 法 确定 系统 中 安装 的 视 
频 编 码 ， 可 以 用 -1 作为 FOURCC 参数 传递 给 VideoWriter 对 象 的 open0 方 法 。 这 样 将 会 打开 一 
个 如 图 13-4 所 示 的 视频 压缩 对 话 框 。 通 过 此 对 话 框 选择 “ffdshow Video Codec” 为 压缩 程序 ， 
并 单 击 “ 配 置 ”按钮 打开 图 中 显示 的 ffdshow 视频 编码 器 设置 对 话 框 ， 在 这 里 可 以 对 视频 编码 
的 一 些 参 数 进行 配置 。 视 频 编码 中 最 重要 的 参数 就 是 码 率 ， 码 率 越 高 ， 视 频 越 清 晰 ， 但 是 视频 
文件 也 越 大。 


Rid el 
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选择 ffdshow Video Codec， 
并 单 击 “ 配 置 ”按钮 


图 13-4 ”视频 压缩 对 话 框 和 编码 器 设置 对 话 框 


但 是 ，VideoWriter 对 象 没有 提供 获取 所 选 视频 编码 的 FOURCC 参数 的 方法 ， 因 此 每 次 运 
行 时 都 需要 通过 对 话 框 来 选择 编码 。 为 了 解决 这 个 问题 ， 本 书 提供 了 下 面 的 小 工具 程序 ， 以 帮 
助 读者 查看 视频 编码 的 FOURCC 参数 。 此 程序 通过 ctypes 库 直 接 调 用 VFW 的 DLL(Dynamic 
Link Library， 动 态 链接 库 )， 显 示 视频 编码 对 话 框 ， 并 输出 所 选中 编码 的 FOURCC 参数 。 


3 we avifile.py 


二。 打开 视频 编码 对 话 杠 ， 并 显示 所 选编 码 的 FOURCC 参数 


通过 上 面 的 程序 可 知 ，ffdshow 对 应 的 FOURCC 参数 是 "ffds"。ffdshow 的 视频 编码 设置 对 
话 框 也 可 以 通过 Windows“ 开 始 ”菜单 中 的 “ffdshow” 一 “VFW configuration” 进 行 配置 。 读 
者 可 以 将 13.2.1 节 介绍 的 制作 水 波动 画 程序 中 的 FOURCC 参数 修改 为 "ffds"， 并 设置 不 同 的 视 
频 编码 参数 来 查看 视频 压缩 效果 。 


13.3 读 写 HDFS 文件 


HDF5 是 存储 科学 计算 数据 的 一 种 文件 格式 , 它 支 持 大 于 2GB 的 文件 , 可 以 把 它 看 做 针对 
科学 计算 的 数据 库 文件 。 关 于 HDFS5 文件 格式 的 更 多 信息 ， 请 参考 下 面 的 链接 : 


© http://www.nsme.cma.gov.cn/FENGYUNCast/docs/HDFS.0_chinese.pdf 
中 文 的 HDF5 使 用 简介 


看 半 兴 汝 内 


465 


讲 半 站 六 嵌 


466 | 


Python 科学 计算 


HDF5 文件 就 像 一 个 保存 数据 的 文件 系统 , 其 中 只 有 两 种 类 型 的 对 象 一 -资料 数据 (dataset) 
和 目录 (group): 

e 资料 数据 (dataset): 像 文 件 系统 中 的 文件 一 样 用 于 保存 各 种 数据 ， 例 如 NumPy 数组 。 

e 目录 (groups): 类 似 于 文件 系统 中 的 文件 夹 ， 可 以 包含 其 他 的 目录 或 资料 数据 。 

HDF5 中 用 于 存 取 对 象 的 路 径 和 文件 系统 的 路 径 类 似 ， 例 如 : 


/MyGroup/Group1/Data 


第 一 个 “/” 表 示 根 目录 , “MyGroup” 和 “Group1” 为 子 目 录 名 , “Data” 为 数据 名 。 

使 用 h5py 模块 可 以 很 方便 地 存 取 HDF5 文件 。 通 过 它 可 以 像 使 用 字典 一 样 操作 HDFS 的 
目录 ， 像 使 用 Numpy 数组 一 样 操作 HDF5 的 资料 数据 。 

下 面 的 实例 演示 了 如 何 使 用 h5py 模块 。 


i hdf5_example.py 
使 用 h5py 创建 HDF5 文件 


由 于 不 能 直接 覆盖 已 经 存在 的 目录 和 数据 ， 因 此 在 运行 “hdf5_example.py” 之 前 , 请 
确保 同一 目录 下 没有 “tmp.hdf5” 文 件 。 


>>> import h5py 
>>> f = h5py.File("tmp.hdf5") 


首先 载 入 h5py 模块 ， 并 创建 一 个 HDF5 文件 对 象 。 和 一 般 的 Python 文件 对 象 一 样 ， 我 们 
可 以 指定 打开 文件 的 模式 为 "r""、"w" 或 "a"， 默 认为 "a"， 表 示 打开 的 文件 可 以 进行 读 写 操作 。 

接 下 来 调用 HDF5 文件 对 象 的 create_group0 方 法 创建 几 个 目录 ,HDFS 文件 对 象 表示 的 根 
目录 以 及 所 有 子 目录 对 象 都 有 create_group0 方 法 ， 通 过 它 可 以 在 任何 目录 中 快速 创建 子 目录 。 
目录 对 象 和 字典 一 样 ， 可 以 通过 keys0 方 法 查询 它 所 包含 的 对 象 名 : 


>>> f.create_ group("group1") 
<HDF5 group “group1”(8 members)> 
>>> f.keys() 

['group1'] 

>>> g2 = f.create_group("group2") 
>>> f.keys() 

[ "group1 ， "group2 ] 

>>> g2 == f["group2"] 

True 

>>> g2.create_group("subgroup1") 
<HDF5 group "subgroup1” (@ members)> 
>>> g2.keys() 

['subgroup1'] 


上 面 的 语句 创建 了 如 下 的 目录 结构 : 


/groupl 
/group2/subgroup1 


可 以 像 添加 字典 元 素 一 样 向 目录 中 添加 数据 : 


>>> g2["a"] = np.arange(6,5) 

>>> g2["a"] 

<HDF5 dataset "a": shape (5,), type "<i4"> 
>>> g2["a"].value 

array([9, 1, 2, 3, 4]) 


HDF5 的 数据 对 象 可 以 直接 参与 计算 : 


>>> np.sum(g2["a"]) 

16 

>>> g2["a"] + np.arange(1，6) 
array([1, 3, 5, 7, 9]) 

>>> g2["a"][-1] = 16 

>>> g2["a"].value 

array([ 8, 1, 2, 3, 19]) 


也 可 以 通过 目录 对 象 的 create_dataset0 方 法 创建 数据 ， 它 的 3 个 参数 分 别 为 资料 名 、 数 组 
的 形状 、 元 素 类 型 : 
>>> d = g2.create dataset("b", (4,4), np.float) 


>>> d[:,8] = 2.6 
>>> d.value 
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如 果 通 过 data 参数 传递 数组 ， 那 么 效果 和 前 面 演示 的 直接 赋值 一 样 : 


>>> g2.create dataset("c", data=np.arange(0, 1.0, 0.2)) 
<HDF5 dataset "c": shape (5,), type "<f8"> 

>>> g2["c"].value 

array([ 8. ， 6.2， 8.4, 8.6, 8.8]) 


和 字典 操作 不 一 样 的 是 ， 不 能 直接 覆盖 已 经 存在 的 数据 ， 必 须 先 使 用 del 关键 字 删 除 现 有 
的 数据 ， 这 样 能 防止 因 误 操作 覆盖 重要 的 数据 : 


>>> g2["a"] = np.linspace(@, 1, 5) 
ValueError: Name already exists (Symbol table: Object already exists) 


让 上 半 兴 消 内 


| 467 


讲 半 闪 消 炎 


Python 科学 计算 


>>> del g2["a"] 

>>> g2["a"] = np.linspace(96，1，5) 

>>> g2["a"].value 

array([ @. ，98.25，6.5 ，68.75，1-. ]) 


HDF5 文件 中 的 目录 和 数据 都 可 以 拥有 元 数据 ， 可 以 通过 attrs 属性 访问 这 些 元 数据 ， 元 数 
据 的 操作 也 和 字典 类 似 : 


>>> g2.attrs 

<Attributes of HDFS object “group2”(6)> 
>>> g2.attrs["title"] = "test data" 

>>> g2.attrs["test"] = np.arange(5) 

>>> g2.attrs 

<Attributes of HDF5 object "group2" (2)> 
>>> g2.attrs["test"] 
array([6，1，2，3，4]) 

>>> 下 .close() 


如 果 读 者 完全 安装 了 Python(x,y), 那么 可 以 使 用 ViTables 工具 查看 HDF5 文件 的 内 容 , 请 
在 “开始 ”菜单 的 Python(x.y) 下 查找 ViTables 的 快捷 方式 。 图 13-5 是 使 用 ViTables 查看 上 面 


所 创建 的 “tmp.hdf5 ”文件 的 界面 截图 ， 从 中 可 以 看 到 我 们 创建 的 3 个 目录 一 一 group1、group2、 
subgroup1，3 个 数据 一 -a、b、c， 以 及 group2 的 元 数据 。 


http://vitables berlios.de/index html 
ViTables 的 下 载 地 址 
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13.4 读 写 Excel 文件 


本 节 介绍 如 何 使 用 xlrd 和 xlwt 库 读 写 Excel 文件 ， 使 用 这 些 库 的 好 处 在 于 它 不 需要 使 用 
COM 接口 驱动 Microsoft Excel， 因 此 不 需要 安装 微软 的 Office 套件 就 可 以 操作 Excel 文件 。 

e xlrd 库 的 下 载 地 址 : http://pypipython.org/pypi/xlrd。 

e xlwt 库 的 下 载 地址 : http://pypipython.org/pypi/xlwt。 

。 xlutils 库 的 下 载 地 址 : http://pypipython.org/pypi/xlutils。 英文 帮助 文档 : http://www.python- 


excel.org。 


13.4.1 写 Excel 文 件 


先 看 看 如 何 使 用 xlwt 库 写 Excel 文件 。 在 xlwt 中 , 用 xlwt.Workbook 对 象 表示 Excel 文件 。 
通过 操作 此 对 象 可 以 修改 Excel 文档 的 内 容 ， 最 后 调用 其 save0 方 法 将 文档 保存 成 文件 。 通 过 
操作 Workbook 对 象 可 以 创建 如 下 对 象 : 

。 WorkSheet: 表示 Excel 文 档 中 的 一 个 工作 表 。 可 通过 Workbook.add_sheet0 创 建 WorkSheet 

对 象 ， 通 过 get_sheet0 获 取 已 经 存在 的 WorkSheet 对 象 。 

e Row: 表示 工作 表 中 的 一 行 ， 可 使 用 WorksheetrowO 创 建 或 获取 。 

e Column: 表示 工作 表 中 的 一 列 ， 可 使 用 Worksheet.col0 创 建 或 获取 。 

e@ Cell: 通过 Worksheet write0 或 Row.write0 可 以 直接 写 指定 的 单元 格 。 

下 面 是 一 个 简单 的 例子 : 


sat write_xls.py 


演示 写 Excel 文件 


import numpy as np 
from xlwt import * 


book = Workbook() 

sheet1 = book.add_sheet(u' 随 机 数 ') 

head = ["normal", "power", "gamma", "SUM"] 

N= 166 

data = np.vstack([ 
np.random.normal(size=N)， 
np.random.power(a=1.0,size=N), 
np.random. gamma(0.9, size=N) 

]) 

# 创建 对 齐 配置 

al = Alignment() 

al.horz = Alignment .HORZ_CENTER 

al.vert = Alignment .VERT_CENTER 

# 创建 边框 配置 
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borders = Borders() 
borders.bottom = Borders.THICK 
# 创建 样式 
style = XFStyle() 
style.alignment = al 
style.borders = borders 
# 获得 第 8 行 
row8e = sheet1.row(6) 
# 将 标题 写 入 第 9 行 ， 使 用 所 创建 的 样式 
for i, text in enumerate(head) : 
rowe.write(i, text, style=style) © 
# 写 入 随机 数 
for i, line in enumerate(data): 
for j, value in enumerate(line): 
sheet1.write(j+1, i, value) 
# 写 求 和 公式 ， 注 意 公式 中 的 单元 格 下 标 从 1 开始 计数 
for i in xrange(N): 
sheet1.row(i+1).set_cell formula( @ 
3, Formula("sum(A%s:C%s)" % (i+2, i+2)), calc flags=1) 


# 设置 4 个 列 的 宽度 

for i in xrange(4): 
sheet1.col(i).width = 4666 © 

# 设置 第 6 行 的 高 度 

sheet1.row(6).height_mismatch = 1 

sheet1.row(6).height = 1666 

book.save("tmp.xls") 


程序 的 输出 文件 如 图 13-6 所 示 。 程序 中 除了 将 数组 写 入 Excel 文件 之 外 , 还 演示 了 各 种 属 
性 的 配置 。 

人 @ 通 过 write0 的 style 参数 指定 单元 格 的 样式 。 样 式 的 创建 比较 麻烦 ， 但 也 很 直观 : 先 分 别 
创建 Aligment、Borders 等 对 象 ， 配 置 样式 的 各 个 属性 ， 然 后 创建 XFStyle 对 象 引 用 各 种 配置 。 
四 通过 Formula 对 象 可 以 将 Excel 的 公式 写 入 文档 。@ 通 过 设置 Row 和 Column 对 象 的 width 
和 height 属性 可 以 设置 行 和 列 的 宽度 和 高 度 。 


后 a E 1 0 
nsrmal Power gmmnma SUM 
| 
至 D05593221 0.274556493 1483073659 1551670341 
3 1051317%2 0 051247001 1235809935 9.235217964 
了 0 转生 时 185 9 076 0.19045264 1 大 7085997 


| $91262334 0 25540963 0019122265 
上 | 5365434227 91980933 0 300733002 
下 
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D028 WhtQ4 DAI1296 2 65193711 ] W569125 
1345543204 0.536077419， 5962567519 了 7.B54553141 
-0 人 3 习 539 D025273177 0612765112 9 E25091491 


图 13-6 用 xlwt 输出 的 Excel 文件 


xlwt 的 Utils 模块 中 有 如 下 经 常会 用 到 的 辅助 函数 : 

e col by name0: 将 列 名 转换 为 列 的 编号 ， 例 如 将 "C" 转 换 为 2。 

e cell to rowcol0: 将 单元 格 的 字符 串 表达 式 变换 为 行列 编号 。 它 返回 一 个 包含 4 个 元 
素 的 元 组 一 ( 行 编号 ， 列 编号 ， 行 是 否 为 绝对 坐标 ， 列 是 否 为 绝对 坐标 )。 

@ cell to rowcol20: 和 cell to rowcol0 类 似 ， 但 是 只 返回 编号 信息 。 

e@ IOowcol to_cell0: 和 cell to rowcol0 相 反 ， 将 编号 变换 为 字符 串 表 达 式 。 

e cellrange to rowcol pair0: 将 字符 串 表 示 的 范围 变换 为 一 个 包含 4 个 元 素 的 元 组 一 一 
(起 始 行 号 ， 起 始 列 号 ， 结 束 行 号 ， 结 束 列 号 ) 

® rowcol pair to_cellrange0: 和 cellrange to rowcol pair0 相 反 。 

下 面 是 几 个 例子 : 


>>> from xlwt import Utils 

>>> Utils.cell to rowcol("C4") 
(3, 2, False, False) 

>>> Utils.cell to rowcol("C8") 
(7, 2, False, False) 

>>> Utils.cell to rowcol2("C8") 
(7, 2) 

>>> Utils.cell to rowcol("$C$8") 
(7, 2, True, True) 

>>> Utils.rowcol to_cel1(266,166) 
"CW281" 

>>> Utils.rowcol to_cell(288,1060, row abs=True, col abs=True) 
"$CW$281" 


13.4.2 读 Excel 文 件 
读 Excel 文件 需要 使 用 xlrd 库 ， 下 面 的 程序 读 入 13.4.1 节 输 出 的 “tmp.xls” 文 件 。 


xlrd 无 法 直接 读 取 xlwd 输出 的 公式 单元 格 , 需要 先 用 Excel 打开 文档 并 保存 之 后 才能 
用 xlrd 计算 公式 单元 格 。 


首先 从 xlrd 库 导入 打开 WorkBook 的 函数 open_workbook0， 并 用 它 打开 “tmp xls” 文 件 : 


可 办 read xls.py 


三 二 ”用 xlrd 库 读 取 Excel 文 件 


>>> from xlrd import open_workbook 
>>> book = open_workbook("tmp.xls") 
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接 下 来 可 以 调用 book 的 属性 和 方法 获得 我 们 所 需要 的 信息 : 


>>> book.nsheets # 工作 表 的 数目 

>>> print book.sheet_names()[8] # 第 一 个 工作 表 的 名 字 
随机 数 

>>> sheet = book.sheets()[8] # 获得 第 一 个 工作 表 


调用 工作 表 对 象 的 cell0、row0 和 col0， 可 以 读 取 其 中 指定 的 单元 格 、 行 以 及 列 中 的 元 素 ， 
这 些 方法 返回 的 是 Cell 对 象 。 如 果 希 望 直接 获得 它们 的 值 ， 可 以 调用 cell value0、row_values0 
和 col_values0 方 法 : 


>>> sheet.cell(86，8) # 读 取 Ad 的 内 容 

text:u'normal 

>>> sheet.row(6) # 读 取 第 一 行 的 内 容 

[text:u'normal', text:u'power', text:u'gamma', text:u'SUM'] 
# 读 取 第 二 列 的 内 容 ， 从 第 二 行 开始 ， 并 对 其 求 和 

>>> sum(x.value for x in sheet.col(1, start_rowx=1)) 
56.686886126367619 

>>> sum(sheet.col values(1, start_rowx=1)) # 同上 
56.686886126367619 

>>> sheet.cel1(1,3) # 读 取 公式 单元 格 的 值 
number:6.41465871399469785 


如 果 我 们 需要 读 取 某 个 Excel 文件 ， 修 改 其 中 的 某 些 内 容 ， 然 后 再 写 回 Excel 文件 中 ， 那 
么 可 以 使 用 xlutils 库 的 copy0 来 快速 完成 从 xlrd.Book 到 xlwtWorkBook 的 转换 复制 工作 。 下 面 
的 程序 在 “tmp.xls” 中 添加 一 些 文字 ， 然 后 将 结果 保存 到 “output.xls” 文 件 中 : 


a modify_ xls.py 
使 用 xlutils.copy0 实 现 Excel 文件 的 修改 


from xlrd import open_workbook 

from xlutils.copy import copy 

rb = open_workbook('tmp.xls',formatting_info=True) 
wb = copy(rb) 

ws = wb.get_sheet(6) 

ws .write(8，4，u" 我 添加 了 一 些 内 容 ") 
wb.save('output.xls') 


个 xlrd 库 无 法 获取 公式 本 身 的 字符 串 ， 因 此 公式 单元 格 无 法 在 复制 过 程 中 保留 下 来 。 


数字 信号 系统 


本 章 以 FIR 和 IIR 滤波 器 为 核心 介绍 数字 信号 系统 中 的 一 些 基 础 知识 。 在 介绍 其 原理 的 同 
时 ， 还 将 用 NumPy 和 SciPy 中 的 相关 函数 直观 地 对 原理 进行 实例 演示 ， 以 帮助 读者 理解 数字 
信号 处 理 的 一 些 理论 知识 。 


14.1 FIR 和 IIR 滤波 器 


在 数字 信号 处 理 领域 中 ， 数 字 滤波 器 占有 非常 重要 的 地 位 。 根 据 其 计算 方式 可 以 分 为 
FIR( 有 限 脉冲 响应 ) 滤 波 器 和 IIR( 无 限 脉冲 响应 ) 滤 波 器 两 种 。 
FIR 滤波 器 的 计算 公式 如 下 : 


y[m] = Bb[O]x[m] + Bll]x{m —1]+:…+b[Plx[m— P] 
IIR 滤波 器 的 直接 1 型 计算 公式 如 下 : 


ylm] = BOlxtm] + Blix —1]+:…+b[Pl]x[m —P] 
—all]y[m—1]— al2]y[m —2]—*…— alQl]y[m — 0] 


其 中 ，x 是 输入 信号 ， 数 组 a 和 是 滤波 器 的 系数 ，y 是 滤波 器 的 输出 。 可 以 把 FIR 滤波 
器 看 作 IIR 滤波 器 的 一 种 特殊 情况 ， 当 系数 a 都 为 0 时 ，IIR 滤波 器 就 变 为 FIR 滤波 器 。 

根据 FIR 滤波 器 的 计算 公式 可 以 得 知 , 时 刻 m 的 输出 yf[m] 由 时 刻 m 的 输入 x[m] 以 及 之 前 
的 输入 x[m-1] .… x[m-P] 和 滤波 器 的 系数 b[0] … b[P] 求 乘积 和 而 得 。 而 IIR 滤波 器 只 不 过 是 再 减 
去 之 前 的 输出 y[m-1] … y[m-Q] 和 系数 a[1] … a[m-Q] 的 乘积 和 。 

总 之 ， 数 字 滤 波 器 的 计算 方法 并 不 复杂 ， 仅 仅 是 数组 对 应 元 素 的 乘积 与 求 和 而 已 。 然 而 其 
计算 量 对 于 Python 来 说 是 相当 大 的 : 通常 FIR 滤波 器 的 系数 都 很 长 , 例如 CD 音质 的 数字 声音 
信号 一 秒 钟 有 44100 个 取样 值 ， 假 设 滤 波 器 的 长 度 是 100， 那 么 一 秒 钟 需要 计算 4 百 万 次 以 上 
的 乘法 和 加 法 运算 ， 这 对 于 Python 这 样 的 动态 语言 来 说 是 很 困难 的 。 

SciPy 的 signal 库 提供 了 lfilter0 来 完成 数字 滤波 器 的 计算 工作 。 由 于 它 的 计算 是 在 C 语言 
级 别 实 现 ， 因 此 运算 速度 很 快 : 


signal.1filter(b，a，x，axis=-1，Zzi=None) 
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其 中 ，b 和 a 是 滤波 器 的 系数 ，x 是 表示 输入 信号 的 数组 。lfilter0 并 不 直接 使 用 前 面 介绍 
的 JR 滤波 器 计算 公式 进行 计算 ， 而 是 对 其 进行 了 如 下 变形 : 


y[m] = b[e]*x[m] + z[@,m-1] (GD 
z[e,m] = b[1]*x[m] + z[1,m-1] - a[1]*y[m] (2) 


z[n-3,m] = b[n-2]*x[m] + z[n-2,m-1] - a[n-2]*y[m] 
z[n-2,m] = b[n-1]*x[m] - a[n-1]*y[m] 


这 段 公式 就 没有 IIR 滤波 器 的 直接 1 型 公式 那么 直 白 了 ,但 是 只 需要 仔细 观察 一 下 就 不 难 
发 现 ， 将 式 (2) 的 时 间 变 为 m-1， 得 到 : 


z[98,m-1] = b[1]*x[m-1] + z[1,m-2] - a[1]*y[m-1] (3) 


将 式 (3) 带 入 式 (1) 中 ， 发 现 b[0]*x[m]、b[1]*x[m-1]、-a[1]*y[m-1] 等 项 是 直接 1 型 公式 中 的 
项 。 将 后 续 的 公式 依次 代入 ， 最 后 得 到 的 公式 将 和 直接 1 型 公式 完全 一 致 ， 这 个 计算 公式 被 称 
为 直接 2 型 。 

在 直接 1 型 公式 中 , 为 了 计算 m 时 刻 的 输出 yf[m]， 除了 需要 m 时刻 的 输入 x[m] 之 外 ,还 
需要 x[m-1] .… x[m-P] 以 及 yfm-1] … y[m-Q], 这 些 值 都 需要 作为 滤波 器 的 内 部 状态 保存 起 来 ， 因 
此 需要 保存 P+Q 个 数值 。 而 根据 直接 2 型 公式 ， 只 需要 保存 z[0] … z[m-2] 即 可 ， 其 中 n 为 系数 
a 和 的 长 度 的 最 大 值 ， 即 max(P, Q)。 

通过 lfilter0 的 五 参数 可 以 指定 滤波 器 的 初始 状态 。 当 五 不 为 None 时 ，lfilter0 将 返回 滤波 
器 的 最 终 状态 zf， 于 是 返回 值 为 (y, zf 。 如 果 元 为 None， 将 只 返回 滤波 器 的 输出 y。 

当 使 用 1filter0 对 很 长 的 输入 信号 进行 滤波 计算 时 , 经 常 需 要 对 数据 进行 分 段 处 理 。 这 时 就 
需要 将 lfilter0 返 回 的 表示 滤波 器 状态 的 数组 zf， 作 为 参数 传递 给 下 一 次 函数 调用 。 下 面 的 程序 
演示 了 这 种 分 段 滤波 的 方法 。 


filter_lfilter_example.py 
六 用 1filter 进行 分 段 滤波 


# 某 个 均衡 滤波 器 的 参数 
a = np.array([1.9，-1.947463616918843，6.9555873761383931] ) 
b = np.array([6.98337165918668479，-1.947463616918843，68.9722157199523452] ) 


# 44.1k Hz，1 秒 的 频率 扫描 波 
t = np.arange(86，6.5，1/44166.9) 
x= signal.chirp(t，fe=19，tl1 = 0.5, f1=1000.0) 


# 直接 计算 滤波 器 的 输出 
y = signal.lfilter(b, a, x) 


# 将 输入 信号 分 为 58 个 数据 一 组 


x2 = x.reshape(-1,50) 
# 滤波 器 的 初始 状态 为 6， 长 度 是 滤波 器 系数 的 长 度 -1 


z = np.zeros(max(len(a),len(b))-1) 

y2 = [] # 保存 输出 的 列表 

for tx in x2: 
# 对 每 段 信 号 进行 滤波 ， 并 更 新 滤波 器 的 状态 z 
ty, z = signal.1filter(b，a，tx，zi=z) 
# 将 输出 添加 到 输出 列表 中 
y2.append(ty) 

# 将 输出 y2 中 的 多 个 数组 链接 成 一 个 一 维 数组 

y2 = np.hstack(y2) 


# 输出 y 和 y2 之 间 的 误差 
print np.sum((y-y2)**2) 


程序 输出 的 误差 为 0， 经 过 均衡 滤波 器 之 后 的 频率 扫描 波形 如 图 14-1 所 示 。 


[a] 9 9,3 Bd 
图 14-1 经 过 均衡 滤波 器 之 后 的 频率 扫描 波形 


程序 中 使 用 的 IR 滤波 器 为 二 次 均衡 滤波 器 ， 其 系数 的 设计 算法 将 在 后 面 的 章节 介绍 。 为 
了 观察 滤波 器 的 频率 特性 ， 我 们 让 它 对 频率 扫描 波 进行 处 理 。 程 序 中 同时 采用 单 次 滤波 和 分 段 
滤波 两 种 方式 调用 lfilter0， 可 以 看 到 它们 的 结果 完全 一 样 。 使 用 分 段 滤波 结合 pyAudio 库 ， 我 


们 很 容易 写 出 对 实时 声音 信号 进行 滤波 的 程序 。 


如 果 将 一 个 脉冲 信号 输入 到 滤波 器 中 ， 那 么 得 到 的 输出 被 称 为 滤波 器 的 脉冲 响应 。 所 谓 及 
冲 信号 ， 就 是 在 时 刻 0 为 1、 在 其 余 时 刻 均 为 0 的 信号 。 根 据 FIR 滤波 器 的 公式 ，FIR 滤波 器 
的 脉冲 响应 就 是 滤波 器 的 系数 。 而 IIR 滤波 器 的 脉冲 响应 就 不 是 很 直观 了 ， 下 面 使 用 lfilter0 计 


算 二 次 均衡 滤波 器 的 脉冲 响应 ， 结 果 如 图 14-2 所 示 。 


sk filter_lfilter_ impulse01.py 
让 志 ”计算 TR 均衡 滤波 器 的 脉冲 响应 
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288 
图 14-2 均衡 滤波 器 的 脉冲 响应 


>>> run filter_1filter_example.py # 运行 前 面 的 例子 ， 得 到 滤波 器 系数 a 和 b 
>>> impulse = np.zeros(1666) 

>>> impulse[6] = 1 

>>> h = signal.1filter(b，a，impulse) 

>>> h[-1] 

-4.2666825265952273e-12 


如 果 观 察 h 的 具体 数值 就 会 发 现 ， 随 着 时 间 的 推移 ，h 越 来 越 小 ， 但 是 始终 不 会 为 0， 其 
脉冲 响应 是 无 限 长 度 的 ， 因 此 才 被 称 为 无 限 脉冲 响应 滤波 器 。 如 果 将 h 当做 FIR 滤波 器 的 系数 
对 信号 x 进行 滤波 ， 得 到 的 结果 和 IIR 滤波 器 的 结果 将 十 分 接近 : 


>>> y3 = signal.lfilter(h, 1, x) 
>>> np.sum((y-y3)**2) 
3.7835244127856444e-17 


显然 ， 由 于 是 逐渐 衰减 的 ， 只 要 测量 足够 长 的 脉冲 响应 ， 就 可 以 用 FIR 滤波 器 足够 精确 
地 模拟 IR 滤波 器 。 图 14-3 显示 的 是 误差 和 FIR 滤波 器 的 长 度 之 间 的 关系 。 由 于 IIR 滤波 器 的 
脉冲 响应 呈 指 数 衰减 ， 因 此 精度 随 着 长 度 呈 指数 增加 ， 请 注意 Y 轴 是 对 数 坐标 。 
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14-3 随 着 FIR 滤波 器 的 长 度 的 增加 ， 误 差 呈 指数 减 小 


14-3 的 计算 程序 如 下 ， 用 lfilter0 计 算 FIR 滤波 器 的 输出 时 ， 需 要 将 参数 a 设置 为 1: 


A# filter lfilter impulse02.py 
读 一 用 FIR 滤波 器 模拟 TIR 滤波 器 


import scipy.signal as signal 
import numpy as np 
import pylab as pl 


# 某 个 均衡 滤波 器 的 参数 
a = np.array([1.9，-1.947463816918843，68.9555873761383931]) 
b = np.array([8.9833716591868479，-1.947463616918843，68.9722157169523452] ) 


# 44.1k Hz，1 秒 的 频率 扫描 波 

t = np.arange(96，6.5，1/44166.9) 

x= signal.chirp(t，f6=16，tl = 6.5，f1=1966.6) 
y = signal.1filter(b，a，x) 

ns = range(16，1168，166) 

err = [] 


for n in ns: 
# 计算 脉冲 响应 
impulse = np.zeros(n，dtype=np.float) 
impulse[6] = 1 
h = signal.lfilter(b, a, impulse) 


# 直接 FIR 滤波 器 的 输出 
y2 = signal.lfilter(h, 1, x) 


# 输出 y 和 y2 之 间 的 误差 
err.append(np.sum( (y-y2)**2)) 


# 绘图 
pl.figure(figsize=(8,4)) 
pl.semilogy(ns , err, "-0") 
pl1.xlabel(u" 脉 冲 响应 长 度 ") 
pl.ylabel(u"FIR 模拟 IIR 的 误差 ") 
pl.show() 


14.2 FIR 滤波 器 设计 


理想 的 低 通 滤波 器 的 频率 响应 如 图 14-4 所 示 。 其 中 , 为 取样 频率 ,为 阻 带 频率 。 通 常 
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为 了 计算 方便 ， 将 取样 频率 正规 化 为 1。 于 是 无 的 含义 就 是 每 个 取样 点 所 包含 信号 的 周期 数 ， 
例如 0.1 表示 每 个 取样 点 包含 0.1 个 周期 ， 即 一 个 周期 有 10 个 取样 点 。 根 据 传 立 叶 变 换 公式 ， 
可 以 求 出 此 理想 低 通 滤波 器 的 脉冲 响应 为 : 


haea (n) 了 =2f.sinc(2f.n) 


其 中 ，n 为 负 无 穷 到 正 无 穷 的 整数 。 显 然 ， 此 脉冲 响应 不 但 无 限 长 ， 而 且 不 满足 因果 律 ， 
因为 对 于 在 0 时 刻 输入 的 脉冲 信号 ， 输 出 信号 在 0 时 刻 之 前 就 有 响应 了 。 


一 


© 


0 频率 fe fs/2 
图 14-4 “理想 低 通 滤波 器 的 频率 响应 


这 样 的 脉冲 响应 当然 无 法 用 FIR 滤波 器 实现 ， 一 个 最 直观 的 近似 方法 就 是 取 how 中 0<n 
< 也 的 工 个 值 当做 低 通 FIR 滤波 器 的 系数 。 下 面 的 程序 计算 此 低 通 滤波 器 的 频率 响应 ， 结 果 如 
图 14-5 所 示 。 程 序 中 使 用 freqz0 计 算 滤 波 器 的 频率 响应 ， 并 用 20log(| h |) 计算 以 分 贝 表示 的 
幅 值 。 


到 filter_firdesign sincl.py 
用 sine 函数 设计 低 通 FIR 滤波 器 ， 取 大 于 0 的 区 间 


import scipy.signal as signal 
import numpy as np 
import pylab as pl 


def h_ideal(n, fc): 
return 2*fc*np.sinc(2*fc*np.arange(0, n, 1.0)) 


b = h_ideal(30, 6.25) 
w, h = signal.freqz(b, 1) 
pl.figure(figsize=(8,4)) 
pl1.plot(w/2/np.pi，26*np.1og16(np.abs(h))) 
pl1.xlabel(u" 正 规 化 频率 周期 /取样 ") 
pl.ylabel(u" 幅 值 (dB)") 

pl.show() 


幅 值 fdB) 
3 


.6 6 8.2 .了 
正规 化 漠 率 周期 /取样 
图 14-5 截取 sinc 函数 的 正 时 间 部 分 作为 脉冲 响应 的 低 通 滤波 器 


用 freqz() 计 算 频 率 响应 
freqz0 用 于 计算 数字 滤波 器 的 频率 响应 ， 它 的 调用 方式 如 下 : 


freqz(b, a=1, worN=None, whole=8, plot=None) 


其 中 , b 和 a 是 滤波 器 的 系数 ，worN 为 所 计算 的 频率 点 数 ，whole 为 0 表示 计算 频率 的 
上 限 为 x，whole 为 1 表示 计算 频率 的 上 限 为 2r。 

它 返 回 一 个 元 组 (wh), 其 中 w 为 表示 频率 的 数组 , 它 的 值 是 正规 化 的 圆 频率 。 通 过 w/(2*pi) 
可 以 计算 对 应 的 正规 化 频率 。h 是 一 个 复数 数组 ,其 长 度 和 w 相同 ， 它 表示 w 中 每 个 频率 对 
应 的 频率 响应 。 复 数 的 幅 值 表 示 滤 波 器 的 增益 特性 ， 相 角 表示 滤波 器 的 相位 特性 。 


14.2.1 用 firwin() 设 计 滤 波 器 


显然 ， 前 面 介绍 的 低 通 滤波 器 的 频率 响应 和 理想 低 通 滤波 器 相差 其 远 ， 并 且 即 使 增加 FIR. 
滤波 器 的 系数 也 没有 作用 。 因 为 我 们 舍弃 了 n<0 的 那 一 半 系 数 ， 而 这 些 系数 有 着 相当 大 的 影 
响 。 因 此 只 截取 n>0 的 部 分 是 不 够 的 ， 如 果 将 n<0 的 那 一 半 系 数 也 添加 进 滤波 器 系数 ， 那 么 
得 到 的 频率 响应 将 会 有 很 大 的 改善 。 按 如 下 所 示 重 新 定义 h ideal0 函 数 ， 它 返回 Psu 中 -n 到 n 
之 间 的 系数 (图 14-6 是 添加 n<0 系数 之 后 的 频率 响应 ): 


> filter_firdesign sinc2.py 
穹 ”用 sinc 函数 设计 低 通 FIR 滤波 器 ， 取 对 称 区 间 


def h_ideal(n, fc): 
return 2*fc*np.sinc(2*fc*np.arange(-n, n, 1.0)) 
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“8 Ex .2 .3 En 8.5 
正规 化 频 柬 周期/ 职 样 


14-6 ”对 称 截取 sinc 函数 的 低 通 滤波 器 


这 样 做 虽然 改善 了 频率 响应 ， 但 却 给 系统 带 来 了 许多 延 时 。 为 了 使 频率 响应 更 接近 理想 低 
通 滤波 器 ， 必 须 增加 滤波 器 的 点 数 ， 然 而 为 了 减少 延 时 ， 又 必须 减少 点 数 。 在 设计 滤波 器 时 ， 
需要 在 精度 和 延 时 之 间 进 行 取舍 。 为 了 在 同样 延 时 的 情况 下 获得 更 好 的 低 通 滤波 效果 ， 可 以 对 
截取 的 滤波 器 系数 进行 窗 函 数 处 理 ， 让 系数 的 两 边 能 更 快 地 收敛 为 0。signal 库 提供 的 farwin0 
采用 此 算法 ， 用 窗 函 数 设计 低 通 滤波 器 ， 它 的 调用 形式 如 下 : 


firwin(N, cutoff, width=None, window="'hamming') 


其 中 ，N 为 滤波 器 的 长 度 ，cuto 人 ff 为 以 £/2 正规 化 的 频率 ，window 为 使 用 的 窗 函数 名 。 

下 面 的 程序 用 frwin0 设 计 低 通 滤波 器 ， 并 且 和 上 面 的 结果 进行 比较 。 注 意 ， 由 于 frwin0 
的 cutoff 参数 是 以 “取样 频率 2” 正规 化 的 ， 因 此 它 是 前 面 介绍 的 大 的 两 倍 ， 结 果 如 图 14-7 
所 示 ( 见 文 前 彩 插 )。 


sl filter_firdesign firwin.py 
使 用 frwin0 设 计 FIR 滤波 器 


import scipy.signal as signal 
import numpy as np 
import pylab as pl 


def h ideal(n, fc): 
return 2*fc*np.sinc(2*fc*np.arange(-n, n, 1.0)) 


b = h_ideal(38，8.25) # 以 fs 正规 化 的 频率 
b2 = signal.firwin(len(b)，8.5) # 以 fs/2 正规 化 的 频率 


w, h = signal.freqz(b) 
w2, h2 = signal.freqz(b2) 


pl.figure(figsize=(8,6)) 
pl.subplot(211) 
pl.plot(w/2/np.pi, 28*np.log10(np.abs(h)), label=u"h ideal") 


pl.plot(w2/2/np.pi, 28*np.log10(np.abs(h2)), label=u"firwin") 
pl.xlabel(u" 正 规 化 频率 周期 /取样 ") 

pl.ylabel(u" 幅 值 (dB)") 

pl.legend() 

pl.subplot(212) 

pl.plot(b, label=u"h ideal") 

pl.plot(b2, label=u"firwin") 

pl.legend() 

pl.show() 


图 14-7 使 用 frwin0 设 计 的 低 通 滤波 器 的 频率 响应 和 脉冲 响应 


使 用 frwin0 设 计 的 滤波 器 并 不 是 最 优 的 ,为 了 实现 同样 的 频率 响应 ， 还 可 以 使 用 长 度 更 
短 的 FIR 滤波 器 。 


14.2.2 用 remez() 设 计 滤波 器 
remez0 能 够 帮助 我 们 找到 更 优 的 滤波 器 系数 ， 它 的 调用 形式 如 下 : 


remez(numtaps, bands, desired, 
weight=None, Hz=1, type="bandpass', maxiter=25, grid_density=16) 


其 中 : 
e numtaps: 所 设计 的 FIR 滤波 器 的 长 度 。 
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e bands: 一 个 递增 序列 ， 包 括 频率 响应 中 所 有 频带 的 边界 ， 值 在 0 到 Hz/2 之 间 。 如 果 
Hz 参数 为 默认 值 1， 那 么 可 以 把 它 当做 以 取样 频率 正规 化 的 频率 。 

e@ desired: 长 度 为 bands 参数 一 半 的 增益 序列 ， 给 出 bands 中 每 个 频带 的 增益 值 。 

e weight: 长 度 和 desired 参数 相同 的 权重 序列 ， 给 出 desired 中 每 个 增益 所 占 的 权重 ， 
值 越 大 表示 越 重要 。 

e@ type: 可 以 是 bandpass' 或 'differentiator， 本 书 只 介绍 type 参数 为 bandpass' 的 情况 。 


remez 算法 

remez 是 一 种 迭代 算法 ， 它 能 够 找到 一 个 n 阶 多 项 式 , 使 得 在 指定 区 间 中 ， 此 多 项 式 和 
指定 函数 之 间 的 最 大 误差 最 小 化 。 由 于 FIR 滤波 器 的 频率 响应 实际 上 是 一 个 多 项 式 函 数 ， 因 
此 可 以 用 remez 算法 进行 FIR 滤波 器 系数 的 设计 。 


remez0 返 回 最 满足 指定 条 件 的 FIR 滤波 器 系数 ， 和 frwin0 一 样 ， 渡 波 器 的 系数 总 是 对 称 
的 。 当 numtaps 参数 为 偶数 时 ， 所 设计 的 滤波 器 在 “取样 频率 /2” 处 的 响应 为 0， 因 此 无 法 设 
计 出 长 度 为 偶数 的 高 通 滤波 器 。 

下 面 的 程序 绘制 由 remez0 设 计 的 高 通 滤波 器 的 频率 响应 ; 


至 filter_ remez.py 


使 用 remez0 设 计 FIR 高 通 滤波 器 


import scipy.signal as signal 
import numpy as np 
import pylab as pl 


for length in [11, 31, 51, 101, 281]: 
b = signal.remez(length, (8, 6.18, 9.2， 9.506), (9.61, 1)) 
w, h = signal.freqz(b, 1) 
pl.plot(w/2/np.pi，26*np.log16(np.abs(h))，1label=str(length)) 

pl.legend() 

pl1.xlabel(u" 正 规 化 频率 周期 /取样 ") 

pl.ylabel(u" 幅 值 (dB)") 

pl.show() 


程序 中 ，remez0 的 bands 参数 设置 两 组 以 取样 频率 正规 化 的 频带 : 0 到 0.18、0.2 到 0.5。 
desired 参数 设置 两 个 频带 的 增益 分 别 为 0.01 和 1。 因 此 这 里 设计 的 是 一 个 通 带 频率 为 02、 阻 
带 增益 为 -40dB 的 高 通 滤波 器 。 

程序 的 运行 结果 如 图 14-8 所 示 , 可 以 看 出 滤波 器 越 长 , 频率 响应 越 接近 设计 值 ( 见 文 前 
彩 插 )。 


-8 Bl 了 ,3 Ea ER 
图 14-8 使 用 remez0 设 计 的 高 通 滤波 器 ， 长 度 越 长 ， 频 率 响应 越 接近 设计 值 


图 14-9 显示 了 权 值 和 频率 响应 之 间 的 关系 ( 见 文 前 彩 插 )， 图 中 滤波 器 的 长 度 为 101。 由 图 
可 知 ， 当 阻 带 和 通 带 的 权 值 为 1 和 0.01( 红 色 曲 线 ) 时 ， 两 个 频带 的 增益 浮动 范围 相同 ， 这 个 权 
值 正好 和 desired 参数 的 设置 相反 。 这 是 因为 在 默认 情况 下 ， 增 益 越 大 的 频带 的 频率 响应 要 求 
越 精确 ， 而 当权 值 和 增益 的 乘积 相等 时 ， 频 率 响应 的 误差 也 就 相同 了 。 


A filter remez weight.py 
remez0 的 权 值 参数 


图 14-9 使 用 remez0 设 计 滤波 器 时 ， 权 值 会 影响 频率 响应 


14.2.3 ”滤波 器 的 级 联 


假设 有 两 个 滤波 器 hl 和 h2， 将 hl 的 输出 信号 输入 到 h2， 这 样 得 到 的 滤波 器 称 为 hl 和 
hz2 的 级 联 。 级 联 后 的 滤波 器 的 脉冲 响应 为 hl 和 bh2 的 脉冲 响应 的 卷 积 ,频率 响应 为 两 个 滤波 器 
的 频率 响应 的 乘积 。 

下 面 的 程序 先 用 remez0 分 别 设计 一 个 高 通 滤波 器 hl 和 一 个 低 通 滤波 器 h2, 然后 通过 卷 积 
计算 出 它们 的 级 联 滤波 器 h3 的 系数 。 最 后 使 用 freqz0 计 算 h3 的 频率 响应 ， 结 果 如 图 14-10 所 
示 ， 可 以 看 出 滤波 器 h3 是 一 个 带 通 滤波 器 。 
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a filter_cascade.py 
使 用 卷 积 将 低 通 和 高 通 滤波 器 级 联 


import scipy.signal as signal 
import numpy as np 
import pylab as pl 


hl = signal.remez(201, (0, 0.18, 8.2， 8.50), (9.61, 1)) 
h2 = signal.remez(201, (86, 8.38, 6.4， 8.50), (1, 98.61)) 
h3 = np.convolve(h1, h2) 


w, h = signal.freqz(h3, 1) 
plL.plot(w/2/np.pi，26*np.1og16(np.abs(h))) 


pl.legend() 
pl1.xlabel(u" 正 规 化 频率 周期 /取样 ") 
pl.ylabel(u" 幅 值 (dB)") 

pl.show() 


“人 Bl 2 .3 Bd .5 
正 归 化 项 素 谋略 / 磷 样 


图 14-10 将 低 通 、 高 通 滤波 器 级 联 ， 得 到 带 通 滤波 器 
也 可 以 直接 用 remez0 设 计 此 带 通 滤波 器 : 
>>> h4 = signal.remez(2601，(6，6.18，6.2，6.38，6.4，6.56)，(8.61，1，96.61)) 


如 果 观 察 此 滤波 器 的 频率 响应 ， 就 会 发 现 它 和 h3 的 基本 一 致 ， 图 14-11 比较 级 联 滤波 器 的 
系数 和 remez0 所 设计 的 带 通 滤波 器 的 系数 ( 见 文 前 彩 插 )。 


58 169 156 2 8 368 358 A609 


14-11 级 联 滤波 器 和 由 remez0 设 计 的 带 通 滤波 器 的 脉冲 响应 近似 


可 以 看 出 ， 虽 然 h3 的 长 度 几乎 是 h4 的 两 倍 ， 但 是 由 于 它 的 许多 系数 都 接近 于 0， 因 此 除 
了 延 时 不 同 之 外 ，h3 和 h4 的 频率 响应 近似 相同 。 


14.3 IIR 滤波 器 设计 


在 设计 数字 IR 滤波 器 时 ， 通 常会 先 设计 一 个 对 应 的 模拟 湾 波 器 ， 然 后 通过 双 线性 变换 
将 模拟 江波 器 转换 为 数字 流 波 器 。 这 意味 着 需要 在 域 中 设计 沪 波 器 的 传递 数 H(S)。 当 HG) 
的 所 有 极点 都 在 s 复 平面 的 左 半 平 面 时 ， 滤 波 器 的 响应 是 稳定 的 。 下 面 以 巴特 沃 斯 低 通 滤波 器 
为 例 说 明 这 一 设计 过 程 。 
14.3.1 巴特 沃 斯 低 通 滤波 器 

巴特 沃 斯 低 通 滤波 器 的 振幅 的 平方 与 频率 之 间 的 关系 可 以 用 如 下 公式 表示 : 


1 瑟 wo)P= 


1+(2)” 
Ce 


其 中 ，n 为 滤波 器 的 阶 数 ，oc 为 振幅 下 降 3dB 时 的 截止 频率 。 这 个 公式 很 容易 理解 : 

e 当 w<owc 时 ，ow 越 小 ， 振 幅 越 接近 于 1 。 

e 当 w>wm。. 时 ，w 越 大 ， 振 幅 越 接近 于 0。 

e 随 着 n 的 增 大 ， 振 幅 接近 于 1 或 0 的 速度 将 变 快 。 即 n 越 大 ， 低 通 滤波 器 在 阻 频带 

的 衰减 速度 将 越 快 。 

e 当 w=oc 时 ， 振 幅 的 平方 为 12， 即 -3dB。 

下 面 我 们 推导 出 巴特 沃 斯 低 通 滤波 器 的 传递 函数 H(s), 其 中 s=6+jw, 是 复数 平面 上 的 点 。 

由 于 当 s=jw 时 ，H(s)H(-s)=| 五 (jw)『， 因 此 将 w=s/j 带 入 到 巴特 沃 斯 低 通 滤 波 器 的 公 
式 中 ， 可 以 得 到 : 


H(s)H(-s) = 二 
1+( 人 CC )” 
起 


此 公式 有 2n 个 极点 ， 其 中 n 个 在 左 半 复 平面 ，n 个 在 右 半 复 平面 ， 由 于 Hts) 必 须 是 稳定 
的 ， 因 此 左 半 平 面 的 n 的 极点 属于 H(s)。 


最 后 得 到 的 传递 函数 为 : 
1 


TE,G-s)/e. 


H(s)= 


其 中 sx 为 左 半 平 面 上 的 极点 : 


Jj(2k+n-DAx 
Se ™ k=1,2,3,...n 
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下 面 的 程序 绘制 6、7 阶 巴 特 沃 斯 低 通 滤波 器 的 s 复 平面 上 的 极点 : 


a filter_butter.py 


巴特 沃 斯 低 通 滤波 器 的 极点 


from scipy import signal 
import numpy as np 
import matplotlib.pyplot as pl 


pl.figure(figsize=(6,6)) 


b, a = signal.butter(6, 1.0, analog=1) 
z,p,k = signal.tf2zpk(b, a) 
pl.plot(np.real(p), np.imag(p), '^',， label=u"6 阶 ") 


b, a = signal.butter(7, 1.0, analog=1) 
z,p,k = signal.tf2zpk(b, a) 
pl.plot(np.real(p), np.imag(p),'s'，, label=u"7 阶 ") 


pl.axis("equal") 
pl.legend(loc="center right") 
pl.show() 


程序 中 ,使 用 butter0 设 计 巴 特 沃 斯 低 通 滤 波 器 , 默认 情况 下 设计 的 是 数字 滤波 器 , 为 了 设 


计 模 拟 滤波 器 ， 需 要 设置 analog 参数 为 1。 获得 传递 函数 的 系数 b 和 a 之 后 , 通过 tf2zpk0 将 它 
们 转换 为 零点 和 极点 ， 结 果 如 图 14-12 所 示 。 


1,0 一 -一 一 一 一 - 


用 ,让 " | 
二 
本 
“8. 
委 
- 
节 a i 
“5 -3,0 一 让 ,号 B,9 


图 14-12 巴特 沃 斯 低 通 滤波 器 在 s 复 平面 上 的 极点 分 布 


注意 ， 当 analog 参数 为 1 时 ，butter0 得 到 的 系数 是 传递 函数 Hls) 的 系数 ， 而 不 是 前 面 介绍 
的 数字 IIR 滤波 器 的 系数 。 假 设 b 和 a 的 长 度 分 别 为 M 和 N， 模 拟 滤波 器 的 系数 中 b[0] 为 分 子 
中 s"™ 项 的 系数 ，a[0] 为 分 母 中 s”“ 项 的 系数 ，b[-1] 和 a[-1] 为 分 子 分 母 的 常数 项 ， 即 : 


bos +hs* ?+..+by 1 


H(s)= 
© te +as™ 十 … 十 Gd 


14.3.2” 双 线性 变换 


有 了 连续 时 间 系 统 的 传递 函数 HGs)， 下 一 步 就 是 将 它 转换 为 离散 时 间 系统 的 传递 函数 HZ)。 
转换 的 方法 有 几 种 ， 其 中 最 常用 的 是 双 线性 变换 ， 其 变换 公式 为 : 


其 中 ，T 为 离散 时 间 系 统 的 取样 周期 。 双 线性 变换 公式 的 推导 过 程 请 参考 下 面 的 链接 ; 


http://en.wikipedia.org/wiki/Bilinear_transform 
双 线 性 变换 公式 的 推导 


区 


双 线性 变换 实际 上 是 s 复 平面 和 z 复 平面 中 点 的 映射 变换 ， 它 将 s 复 平面 中 的 竖 线 变换 成 
z 复 平面 中 的 圆 ， 而 s 复 平面 中 的 Y 轴 对 应 于 z 复 平面 中 的 单位 圆 。 下 面 的 程序 演示 了 这 一 对 
应 关系 ， 结 果 如 图 14-13 所 示 ( 见 文 前 彩 插 )。 


a filter_bilinear_transform.py 
双 线 性 变换 演示 


import numpy as np 
import pylab as pl 


def stoz(s): 


将 s 复 平面 映射 到 z 复 平面 
为 了 方便 起 见 ， 假 设 取样 周期 T=1 


return (2+S)/(2-s) 


def make_vline(x): 
return x + 1j*np.linspace(-1060.0,1060.0,20000) 


fig = pl.figure(figsize=(7,3)) 
axs = pl.subplot(121) 
axz = pl.subplot(122) 
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for x in np.arange(-3, 4, 1): 
s = make_vline(x) 
z = stoz(s) 
axs.plot(np.real(s), np.imag(s)) 
axz.plot(np.real(z), np.imag(z)) 
axs.set_xlim(-4,4) 
axz.axis("equal") 
axz.set ylim(-3,3) 


pl.show() 


程序 中 ，stoz0 将 s 复 平面 中 的 点 变换 为 z 复 平面 中 的 点 ， 为 了 方便 起 见 ， 这 里 假设 取样 周 


期 T 为 1。 

189 
3 
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1 
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图 14-13 ” 双 线 性 变换 将 s 复 平面 中 的 竖 线 ( 左 图 ) 变 换 为 z 复 平面 中 的 圆 ( 右 图 ) 


进行 双 线性 变换 之 后 ， 滤 波 器 的 频率 响应 会 发 生变 化 。 将 离散 时 间 系 统 的 传递 函数 H(3) 
用 :=e/*" 进行 蔡 换 ， 就 可 以 得 到 其 频率 响应 。 将 其 带 入 双 线性 变换 公式 ， 得 到 : 


加 2 -1 硬 2eer_1 NR 2 elar/2 _er1er12 四 
中 3 


和 
) 一 tan(O7 /2 
4 ) 


对 于 s 复 平面 上 的 点 来 说 ， 过 原点 的 竖 线 s=jw 就 是 连续 时 间 系统 的 传递 函数 HGs) 的 频率 
响应 ， 因 此 双 线 性 变换 将 离散 时 间 系统 的 频率 w 通过 如 下 公式 转换 为 连续 时 间 系 统 的 频率 ou: 


ON = 子 aa(or/) 
其 反 函 数 为 : 
@= Farctan(e,T /2) 


下 面 我 们 用 程序 验证 这 个 频率 转换 公式 。 首 先 载 入 所 需要 的 库 ， 并 且 定义 离散 时 间 系 统 的 
取样 频率 代为 8k Hz， 所 设计 的 巴特 沃 斯 低 通 滤波 器 的 通 带 截止 频率 代为 1k Hz: 


filter bilinear freq.py 
让 二 验证 双 线 性 变换 的 频率 转换 公式 


>>> from scipy import signal 
>>> from numpy import * 

>>> fs = 8666.0 

>>> fc = 1966.9 


下 面 使 用 butter0 设 计 一 个 3 阶 的 巴特 沃 斯 低 通 滤波 器 。 注 意 ，analog 参数 为 1， 表 示 设 计 
连续 时 间 系 统 的 传递 函数 H(s) 的 系数 。 由 于 通 带 截止 频率 参数 为 圆 频率 ， 因 此 需要 将 通 带 截止 
频率 化 乘 以 2x: 


>>> b, a = signal.butter(3, 2*pi*fc, analog=1) 


然后 调用 双 线 性 变换 函数 bilinear0, 将 传递 函数 转换 为 离散 时 间 系 统 , 通过 参数 指定 取 
样 频 率 : 


>>> b2, a2 = signal.bilinear(b,a,fs=fs) 


接 下 来 用 freqz0 得 到 此 数字 滤波 器 的 频率 响应 , 为 了 得 到 尽 可 能 精确 的 值 , 我 们 通过 worN 
参数 设置 它 计 算 10000 点 的 频率 响应 : 


>>> w2, h2 = signal.freqz(b2,a2,worN=16666) 
接 下 来 将 h2 转换 为 增益 ,并 且 找 到 增益 为 -3dB( 精 确 值 为 10*log10(0.5)) 时 对 应 的 正规 化 圆 
频率 w 的 下 标 idx，w/(2*pi)*fs 就 是 其 对 应 的 实际 频率 值 : 


>>> p2 = 26*1og16(abs(h2)) 

>>> idx = argmin(abs(p2-16*log16(86.5))) 
>>> w2[idx]/2/pi*fs 

952.8 


通过 频率 转换 公式 得 到 的 离散 时 间 系 统 的 截止 频率 为 : 


>>> 2*fs*arctan(2*pi*fc/2/fs) /2/pi 
952.8846223 


实际 使 用 signal 库 设计 IIR 滤波 器 时 没有 这 么 麻烦 ， 因 为 它 所 提供 的 滤波 器 设计 函数 默认 
都 是 直接 设计 数字 滤波 器 。 这 些 函数 在 设计 数字 滤波 器 时 采用 的 取样 频率 为 2， 即 以 香农 频率 


fs/2 为 1 进行 正规 化 。 因 此 要 设计 取样 频率 为 全 、 通 带 频率 为 了 的 滤波 器 ， 需 要 将 通 带 频率 正 
规 化 为 Wfs/2)。 下 面 调 用 butter0 设 计数 字 低 通 滤波 器 ， 这 里 使 用 前 面 计算 得 到 的 通 带 频率 ， 


>>> b3,a3 = signal.butter(3，952.8846223/(fs/2)) 


警 洲 由 二 必 秋 


489 


演 济 咖 评 改 秋 


490 


Python 科学 计算 


>>> sum(abs(b3-b2)) 
1.3226225670237568e-13 
>>> sum(abs(a3-a2)) 
7.8876637892869994e-13 


前 面 计算 得 到 的 滤波 器 的 系数 b3 和 a3 与 通过 bilinear0 计 算 的 系数 b2 和 a2 是 一 致 的 。 在 
使 用 signal 库 设计 数字 滤波 器 时 ， 其 内 部 会 先 通过 频率 转换 公式 对 频率 进行 转换 ， 然 后 设计 传 
递 函 数 的 系数 ， 最 后 通过 bilinear0 进 行 系数 转换 。 有 兴趣 的 读者 可 以 查看 irfilter0 的 源 代 码 。 


14.3.3 ”滤波 器 的 频带 转换 


只 要 知道 了 低 通 滤波 器 的 传递 函数 Hls)， 就 很 容易 利用 变量 蔡 换 法 设计 出 同样 阶 数 的 高 通 、 
带 通 或 其 他 通 带 频率 的 低 通 滤波 器 。 

假设 采用 巴特 沃 斯 低 通 滤波 器 的 设计 公式 ， 设 计 出 如 下 通 带 频 率 为 1 弧度 / 秒 的 标准 低 通 
滤波 器 : 


>>> b, a = signal.butter(2，1.6，analog=1) 
>>> np.real(b) 


array([ 1.]) 
>>> np.real(a) 
array([ 1. » 1.41421356, 1。 ]) 


此 滤波 器 的 传递 函数 如 下 : 


1 


Od tp 
s +1.4142s +1 


为 了 让 它 变 为 通 带 频率 为 w。 的 低 通 滤波 器 ， 只 需要 进行 如 下 变量 蔡 换 : 


E24 
3 一 一 
O 


< 


由 于 将 ssjw 代入 传递 函数 Hls) 就 能 得 到 滤波 器 的 频率 响应 ， 因 此 上 面 设 计 的 标准 低 通 滤 
波 器 HG) 在 o=1 时 的 增益 为 -34B。 而 Hls/wy 在 o=oc 处 的 增益 为 -34B。 下 面 的 语句 计算 通 带 
频率 为 2 弧度 / 秒 的 低 通 滤波 器 的 系数 : 


>>> b2, a2 = signal.butter(2, 2.0, analog=1) 
>>> np.real(b2) 

array([ 4.]) 

>>> np.real(a2) 

array([ 1. 2 220427125 45 ]) 


可 以 看 出 ， 将 * > 代入 到 标准 低 通 汪 波 器 的 传递 函数 中 即 可 得 到 这 些 系 数 。 


低 通 滤波 器 转 高 通 滤波 器 的 变量 蔡 换 公式 为 : 


此 公式 也 很 容易 理解 : 

e 若 o 为 0, 则 替代 之 后 的 频率 为 无 穷 大 , 而 低 通 滤波 器 在 频率 为 无 穷 大 时 的 响应 为 0， 
即 转换 之 后 的 滤波 器 在 0 处 的 频率 响应 为 0。 

e 若 o 为 无 穷 大 ， 则 替代 之 后 的 频率 为 0， 因 此 转换 之 后 的 滤波 器 在 频率 为 无 穷 大 时 的 
响应 为 1 。 

下 面 设计 通 带 频率 为 1 弧度 / 秒 的 高 通 滤波 器 : 


>>> b3,a3 = signal.butter(2,1.6,btype="high",analog=1) 
>>> np.real(b3) 

array([ 1.， 09: 9.]) 

>>> np.real(a3) 

array([ 1. ， 1.41421356， 1. ]) 


可 以 看 出 ， 这 些 系数 是 将 。_> 荆 代入 到 页 g) 中 之 后 ， 分 子 和 分 母 分 别 乘 以 衬 得 到 的 。 
Ey 


低 通 滤波 器 还 可 以 转换 为 带 通 滤波 器 。 这 可 能 有 点 难以 理解 ， 我 们 先 看 看 变量 替换 公式 。 
假设 带 通 滤波 器 的 高 低 通 带 频 率 为 > 和 wz: 


Co ,SS @ 
一 一 (- 一 + 一 ) 
Aw mo 3 


其 中 ，Ao = oa -四 ，owo = oo 。A@ 被 称 为 通 带 带 宽 ，oo 则 是 通 带 的 中 心 频率 。 
我 们 通过 下 面 的 程序 演示 低 通 滤波 器 是 如 何 转换 成 带 通 滤波 器 的 : 


和 A Filter_bandpass_iir.py 


福 一 低 通 滤波 器 转 带 通 滤波 器 的 原理 演示 


import numpy as np 
from scipy import signal 
import pylab as pl 


b, a = signal.butter(2，1.6，analog=1) © 


# 低 通 -> 带 通 的 频率 变换 函数 
wl = 1.8 # 低 通 带 频率 
w2 = 2.6 # 高 通 带 频率 
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dw = w2 - wl # 通 带 宽度 
we = np.sqrt(w1*w2) # 通 带 中 心 频 率 


# 产生 16**-2 到 16**2 的 频率 点 
WwW = np.1logspace(-2，2，1666) © 


# 使 用 频率 变换 公式 计算 出 转换 之 后 的 频率 
nw = np.imag(w8/dw*(1j*w/we + we/(1j*w))) © 


_，h = signal.freqs(b，a，worN=nw) @ 
h = 269*np.1og16(np.abs(h)) 
pl.figure(figsize=(8,5)) 
pl.subplot(221) 

pl.semilogx(w，nw) # X 轴 使 用 log 坐标 绘图 
pl.xlabel(u" 变 换 前 圆 频率 (弧度 / 秒 )") 
pl.ylabel(u" 变 换 后 圆 频率 (弧度 / 秒 )") 
pl.subplot(222) 

pl.plot(h, nw) 
Pp1.xlabel(u" 低 通 滤波 器 的 频率 响应 (dB)") 
pl.subplot(212) 

pl.semilogx(w, h) © 
pl.xlabel(u" 变 换 前 圆 频率 (弧度 / 秒 )") 
pl.ylabel(u" 带 通 滤波 器 的 频率 响应 (dB)") 


pl.subplots_adjust(wspace=8.3, hspace=0.3, top=8.95, bottom=0.14) 


print "center:", w[np.argmin(np.abs(nw))] 
pl.show() 


@ 先 用 butter0 设 计 一 个 模拟 的 二 阶 标准 低 通 滤波 器 ,将 其 转换 为 通 带 频率 为 wl=1 到 w2=2 
的 带 通 滤波 器 。 @ 使 用 logspace0 产 生 频 率 段 为 0.01 到 100 的 等 比 数列 w， 此 后 的 频率 响应 运 
算 都 针对 w 进行 。 

四 通 过 带 通 频率 转换 公式 将 其 转换 为 新 的 频率 序列 nw。@ 并 使 用 nw 计算 每 个 频率 点 对 应 
的 低 通 滤波 器 的 频率 响应 ， 我 们 通过 freqs0 的 worN 参数 指定 需要 计算 频率 响应 的 频率 点 。 

@ 用 semilogx0 将 h 和 w 的 关系 绘制 成 如 图 14-14( 下 ) 所 示 的 对 数 坐标 图 ， 即 带 通 滤波 器 的 
频率 响应 ,左上 图 绘制 的 是 频率 转换 函数 , 右上 图 绘制 的 是 低 通 滤波 器 的 频率 响应 (X 轴 为 响应 ， 
立轴 为 频率 )。 
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图 14-14 ”使 用 频率 转换 公式 将 低 通 滤波 器 变 为 带 通 滤波 器 


由 于 带 通 滤波 器 的 频率 转换 公式 将 0 到 无 穷 大 映射 到 负 无 穷 到 正 无 穷 , 而 低 通 滤波 器 在 正 
负 无 穷 处 的 频率 响应 都 为 0， 因 此 可 以 想象 转换 后 的 滤波 器 是 一 个 带 通 滤波 器 。 而 中 心 频率 oo 
经 公式 转换 之 后 的 值 为 0， 低 通 滤波 器 在 0 处 的 频率 响应 为 1， 因 此 带 通 滤波 器 在 wo 处 的 频率 
响应 为 1 。 

事实 上 ，signal 库 已 经 提供 了 频带 转换 函数 : 

e lp2lp0: 低 通 转 低 通 。 

e lp2hp0: 低 通 转 高 通 。 

e lp2bp0: 低 通 转 带 通 。 

e lp2bs0: 低 通 转 带 阻 。 

下 面 以 lp2bp0 为 例 简要 说 明 函 数 的 用 法 。 假 设 b、a 为 二 阶 标准 低 通 滤波 器 ， 下 面 的 程序 
将 其 转换 为 通 带 为 1 到 2 的 带 通 滤 波 器 。lp2bp0 的 前 两 个 参数 为 滤波 器 的 系数 ， 后 两 个 参数 分 
别 为 中 心 频率 和 通 带 带宽 : 


>>> b, a = signal.butter(2, 1.0, analog=1) 
>>> b3, a3 = signal.lp2bp(b,a,np.sqrt(2), 1) 


也 可 以 直接 调用 butter0 设 计 一 个 低 通 滤波 器 ; 
>>> b4, a4 = signal.butter(2, [1,2], btype="bandpass', analog=1) 
二 者 的 结果 是 完全 一 致 的 : 


>>> np.all(b3==b4) 
True 
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>>> np.all(a3==a4) 
True 


14.4 ”数字 滤波 器 的 频率 响应 


前 面 的 许多 例子 都 是 使 用 freqz0 计 算数 字 滤 波 器 的 频率 响应 ， 本 节 将 深入 研究 freqz0 是 如 
何 计算 频率 响应 的 。 在 IPython 中 输入 : 


>>> import scipy.signal 
>>> signal.freqz?? 


即 可 看 到 freqz0 的 代码 ， 下 面 是 其 完整 的 源 程序 : 


def freqz(b, a=1, worN=None, whole=8, plot=None): 
b, a = map(atleast 1d, (b,a)) 
if whole: 
lastpoint = 2*pi 
else: 
lastpoint = pi 
if worN is None: 
N= 512 
w = numpy.arange(@, lastpoint, lastpoint/N) 
elif isinstance(worN, types.IntType): 


N = worN 

w = numpy.arange(@, lastpoint, lastpoint/N) 
else: 
Ww = worN 


Ww = atleast_1d(w) 
zml = exp(-1j*w) 
h = polyval(b[::-1], zm1) / polyval(a[::-1], zm1) 
if not plot is None: 
plot(w, h) 
return w, h 


研究 这 段 代 码 ， 不 难 发 现 真正 计算 频率 响应 的 代码 可 以 用 如 下 3 行 代码 概括 : 


WwW = numpy.arange(9,pi,pi/N) 
zml = exp(-1j*w) 
h = polyval(b[::-1], zm1) / polyval(a[::-1], zm1) 


为 了 和 弄 清 楚 为 什么 这 3 行 代码 能 够 计算 数字 滤波 器 的 频率 响应 , 让 我 们 先 来 学 习 一 下 相关 


的 理论 知识 。 
数字 滤波 器 的 频率 响应 由 滤波 器 的 传递 函数 给 出 ，IIR 滤波 器 的 计算 公式 如 下 : 


ym] = blOlx[m] + Bll]x[m -HT+…+2LP]x[m — P] 
—allly[m ~—1]—al2]ylm—2]—…—alQlylm— 0] 


根据 Z 变换 的 相关 公式 ， 很 容易 求 得 其 传递 函数 为 : 


7() _ BO]+ =-20]+ =-22[2]+…+=-%O[P] 


ROE I+ + 2 +t alO] 


其 中 ，z 为 复数 平面 上 的 任意 一 点 。 当 z 为 单位 圆 上 的 点 ， 即 = =e” 时 ，Hfew) 就 是 滤波 器 
的 频率 响应 。o 被 称 为 圆 频 率 ， 当 其 取 值 从 0 到 2x 变化 时 ，e” 正 好 绕 复数 平面 单位 圆 转 一 圈 。 
由 于 复数 平面 上 下 两 个 半 平 面 的 复数 存在 共 生 关 系 ， 因 此 通常 只 需要 求 得 上 半圆 的 频率 响应 即 
可 。 下 面 的 语句 将 上 半圆 等 分 为 N 份 : 


Ww = numpy.arange(6,pi,pi/N) 
然后 计算 w 中 每 点 对 应 的 复数 值 e-” : 
zml = exp(-1j*w) 


于 是 ， 传 递 函数 的 分 子 分 母 部 分 就 都 变 成 了 zml 的 多 项 式 函数 。 最 后 将 zml 代入 传递 函 
数 的 公式 中 ， 计 算出 频率 响应 h: 


h = polyval(b[::-1]，zml) / polyval(a[::-1], zm1) 
polyval(p, x) 对 数组 x 中 的 每 个 元 素 计算 多 项 式 p 的 值 ， 其 计算 公式 如 下 : 
p[@]*(x**N-1) + p[1]*(x**N-2) + ... + p[N-2]*x + p[N-1] 


由 于 滤波 器 系数 b 和 a 的 顺序 正好 和 polyval0 的 多 项 式 系数 p 的 顺序 相反 ， 因 此 通过 数组 
切片 运算 b[::-1] 将 滤波 器 的 系数 反 转 。 由 于 数组 zml 中 的 值 都 为 复数 ， 因 此 得 到 的 频率 响应 h 
的 值 也 都 是 复数 。 复 数 的 幅 值 对 应 于 频率 响应 中 的 增益 特性 ， 相 角 对 应 于 频率 响应 中 的 相位 
特性 。 

我 们 经 常 需要 在 绘制 频率 响应 图 表 时 要 求 频率 坐标 为 对 数 坐标 。 对 于 对 数 坐标 ，arangeO 
创建 的 等 距 的 频率 数组 w 会 造成 低频 过 朴 、 高 频 过 密 的 问题 。 为 了 解决 这 个 问题 ， 可 以 先 用 
logspace0 计 算 一 个 等 比 的 频率 数组 ， 并 通过 worN 参数 将 其 传递 给 freqz0。 当 worN 参数 是 一 
个 序列 对 象 时 ，freqz0 对 其 中 指定 的 频率 计算 响应 。 
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a filter logfreqz.py 
用 freqz0 计 算 对 数 坐标 的 频率 响应 


import numpy as np 
import pylab as pl 
import scipy.signal as signal 


def logfreqz(b, a, fe, f1, fs, N): 
以 对 数 频率 坐标 计算 滤波 器 b、a 的 频率 响应 
fe，f1: 计算 频率 响应 的 开始 频率 和 结束 频率 
fs: 取样 频率 


we, wl = np.log10(fe/fs*2*np.pi), np.log10(f1/fs*2*np.pi) © 
# 不 包括 结束 频率 

w = np.logspace(we, wl, N, endpoint=False) © 

_，h = signal.freqz(b, a, worN=w) © 

return w/2/np.pi*fs, h 


for n in range(1, 6): 
# 设计 n 阶 的 通 频 为 6.1*4666 = 466 Hz 的 高 通 滤波 器 
b, a = signal.iirfilter(n，[6.1，1]) @ 
f，h = logfreqz(b，a，16.6，4666.6，8668.6，469) 
gain = 26*np.1log16(np.abs(h)) 
pl.semilogx(f, gain, label="N=%s" % n) 
slope = (gain[166]-gain[16]) / (np.1og2(f[166]) - np.1og2(f[16])) © 
print "N=%s, slope=%s dB" % (n, slope) 
pl.ylim(-160, 28) 
pl.xlabel(u" 频 率 (Hz)") 
pl.ylabel(u" 增 益 (dB)") 
pl.legend() 
pl.show() 


程序 中 ，logfreqz0 计 算 系 数 为 b 和 a 的 滤波 器 在 各 到 了 之 间 的 频率 响应 ， 为 取样 频率 ， 
N 为 计算 的 点 数 。@ 首 先 通过 2z .jy/ 大 将 实际 频率 转换 为 与 之 对 应 的 圆 频率 。 思 然后 通过 
logspaceO 计 算 频率 点 的 等 比 数列 。 旨 最 后 调用 freqz0 计 算 等 比 数列 中 每 点 的 频率 响应 ， 返 回 值 
为 以 Hz 为 单位 的 频率 及 其 对 应 的 频率 响应 。 

@ 调 用 iirfilter0 设 计 5 个 不 同 阶 数 的 IIR 高 通 滤波 器 , 通 频 为 0.1。 如 果 取 样 频率 为 8 kHz， 
那么 实际 的 通 频 为 0.1*4k Hz=400 Hz。5 个 IIR 滤波 器 的 增益 特性 如 图 14-15 所 示 ( 见 文 前 彩 插 )。 


增 结 (dB) 
1 
3 


1 0 
霹 昌 (kz) 


14-15 使 用 iirfilter0 设 计 5 个 不 同 阶 的 IIR 高 通 滤波 器 


由 图 14-15 可 知 ， 随 着 IIR 滤波 器 阶 数 的 增加 ， 增 益 的 下 降 速 度 也 在 增加 。@ 计 算 增益 下 
降 时 倍 频 之 间 的 增益 差 值 ， 结 果 如 下 : 


N=1, slope=5.9955865774 dB 
N=2，slope=12.6417261651 dB 
N=3，slope=18.6636862632 dB 
N=4，slope=24.6841135443 dB 
N=5, slope=30.1051375912 dB 


即 IR 滤波 器 的 阶 数 每 增加 1， 增 益 的 下 降 速 度 增 加 6dB/oct (6dB 每 倍 频 )， 并 且 所 有 曲线 
相交 于 一 点 一 一 此 处 的 频率 正好 是 400 Hz， 增 益 为 -3 dB。 


14.$ ”二 次 均衡 滤波 器 设计 工具 


无 论 是 古老 的 盒 式 录音 机 还 是 现代 的 流行 数码 音响 设备 ， 抑 或 众多 的 音乐 播放 软件 ， 其 中 
绝 大 多 数 的 均衡 器 都 只 是 由 一 系列 简单 的 二 次 IIR 滤波 器 组 合 而 成 。 
二 次 IIR 滤波 器 的 传递 函数 如 下 : 


bO+bl:= 1 +b2:2™ 


H(z:)= 
© a0+al:= 1 +a2:=™ 


当 a0 的 值 不 为 1 时， 可 以 将 所 有 系数 (b0、bl1、b2、a0、al、a2) 都 除 以 a0， 这 样 就 能 得 到 
a0=1 时 的 5 个 系数 一 b0、bl、b2、al、a2， 即 二 次 均衡 滤波 器 的 频率 响应 曲线 由 这 5 个 独立 
的 参数 决定 ， 其 频率 响应 如 图 14-16 所 示 ( 见 文 前 彩 插 )。 
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所 机 (2) 


频 虽 (Mz) 
图 14-16 二 次 均衡 滤波 器 的 频率 响应 


从 图 14-16 中 可 以 看 出 频率 响应 曲线 的 两 个 参数 一 中 心 频率 fg 和 振幅 峰值 peak: 

。 频率 为 0 时 ， 频 率 响应 为 1。 

e 频率 为 取样 频率 一 半 时 ( 圆 频率 为 z)， 频 率 响应 为 1 。 

。 频率 为 中 心 频率 人 时 ， 振 幅 达 到 峰值 peak。 

。 频率 响应 在 中 心 频率 名 处 的 导数 为 0。 

。 这 样 就 有 了 4 个 方程 ， 再 加 上 一 个 Q 值 决定 振幅 驼峰 的 宽度 ， 因 此 一 共 5 个 方程 决 

定 5 个 系数 。 

Audio EQ Cookbook 中 提供 了 二 次 均衡 滤波 器 系数 的 设计 公式 ， 根 据 这 个 设计 手册 ， 很 容 

易 写 出 如 下 设计 二 次 均衡 滤波 器 参数 的 函数 : 


© http://www.musicdsp.org/files/Audio-EQ-Cookbook.txt 
二 次 IIR 滤波 器 参数 设计 大 全 一 一 Audio EQ Cookbook 


和 A fater equalizerpy 
也 二 设计 二 次 均衡 滤波 器 的 参数 


import scipy.signal as signal 
import pylab as pl 

import math 

import numpy as np 


def design equalizer(freq, Q, gain, Fs): 
"'"' 设 计 二 次 均衡 滤波 器 的 系数 '"" 
A = 10**(gain/40.0) 
we = 2*math.pi*freq/Fs 
alpha = math.sin(we) /2/Q 


be =1+alpha *A 

bl = -2*math.cos(we) 

b2=1 -alpha*A 

ae =1+alpha /A 

al = -2#xmath.cos(w8) 

a2=1-alpha/A 

return [be/ae,bl/ae,b2/a8]，[1.6，al/a8e，a2/a6] 


pl.figure(figsize=(8,4)) 
for freq in [1000, 2600, 4060]: 
or gin [0:5; 1:0]: 
for p in [5, -5, -10]: 
b,a = design_equalizer(freq，q，p，44166) 
w, h = signal.freqz(b, a) 
pl.semilogx(w/np.pi*44196，26*np.1og16(np.abs(h))) 
pl1.xlim(166，44166) 
pl.xlabel(u" 频 率 (Hz)") 
pl.ylabel(u" 振 幅 (dB)") 
pl.subplots_adjust(bottom=0.15) 
pl.show() 


使 用 前 面 介绍 的 对 数 频率 响应 的 求法 以 及 TraitsUI 和 Chaco 等 界面 库 , 我 们 可 以 设计 如 图 
14-17 所 示 的 二 次 均衡 滤波 器 设计 程序 。 


可 filter_equalizer_designer.py 
半 一 二 次 均衡 滤波 器 设计 器 


14-17 二 次 均衡 滤波 器 设计 工具 的 界面 


警 沙 巾 二 必 秋 
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用 户 可 以 使 用 此 程序 添加 、 删 除 和 编辑 二 次 均衡 滤波 器 ， 并 且 可 以 即时 查看 均衡 器 级 联 之 
后 的 频率 响应 ， 还 可 以 将 设计 好 的 滤波 器 系数 输出 为 如 下 的 C 语言 文件 : 


double EQ PARS[][5] = { 
//b8,b1,b2,al,a2 // frequency, Q, gain 
{1.86673497929, -1.97887298381,8.978711789885， 
-1.97887298381,8.979446688291}, // 169.9,1.12,8.6 


1 
14.6 ” 零 相 位 滤波 器 


使 用 signal 库 的 lfilter0 对 数据 进行 滤波 时 ,会 产生 相位 偏 移 ， 这 是 因为 实时 的 信号 处 理 滤 
波 器 在 计算 t 时 刻 的 滤波 器 的 输出 时 ， 只 能 使 用 之 前 的 输入 和 输出 信号 , 否则 就 不 满足 因果 律 。 
然而 很 多 情况 下 ， 我 们 可 以 先 将 输入 信号 完全 记录 下 来 ， 然 后 再 进行 处 理 ， 这 时 就 可 以 使 用 不 
满足 因果 律 的 滤波 函数 fltfilt0 进 行 滤波 ， 它 能 够 保证 输出 信号 和 输入 信号 的 相位 完全 一 致 。 下 
面 的 程序 演示 了 fntfilt0 的 滤波 结果 : 


sl filter_filtfilt.py 
零 相 位 滤波 器 演示 


import numpy as np 
from scipy import signal 
import pylab as pl 


t = np.arange(-1, 1, 8.61) 
x = np.sin(np.pi*t+2) + np.random.randn(len(t))*6.65 


[b,a] = signal.butter(3，6.65) 
z = signal.lfilter(b, a, x) 
y = signal.filtfilt(b, a, x) 


pl.figure(figsize=(8,4)) 
pl.plot(x，label=u" 原 始 数据 ") 
pl.plot(z，label=u"1filter 滤波 ") 
pl.plot(y，label=u"filtfilt 滤波 ") 
pl.legend() 

pl.show() 


程序 中 ,我 们 首先 创建 一 个 带 噪声 的 正弦 波 信号 x， 然 后 用 butter0 设 计 一 个 3 阶 的 低 通 滤 
波 器 , 分 别 使 用 lfilter0 和 fntfilt0 对 此 信号 进行 滤波 ,得 到 的 结果 如 图 14-18 所 示 ( 见 文 前 彩 插 )。 
可 以 看 出 ，lfilter0 会 产生 一 些 延 时 ， 但 fitfilt0 的 结果 与 原 信号 完全 同步 。 


一 ”原由 时 所 
一 lfilter 迄 波 
一 ”filtfilt 淖 波 


二 全 ED 189 58 ie 


图 14-18 filtfilt0 的 滤波 结果 没有 相位 变化 


14.7 重 取 样 


把 模拟 信号 转换 为 数字 信号 ,需要 对 模拟 信号 按照 一 定 的 取样 频率 进行 取样 。 对 于 声音 信 
号 ， 比 较 常 用 的 取样 频率 有 8000 Hz、11025 Hz、16000 Hz、22050 Hz、32000 Hz、44100 Hz、 
48000 Hz 等 ， 另 外 还 有 高 取样 频率 88200 Hz 和 96000 Hz 等 。 例 如 ，CD 采用 的 是 44100 Hz， 
电话 则 一 般 采 用 8000 Hz，MP3 文件 格式 则 支持 48000 Hz 以 下 所 有 的 取样 频率 。 

假设 要 设计 MP3 播放 器 ， 为 了 能 够 播放 所 有 取样 频率 ， 可 以 采用 两 种 办 法 : 一 种 是 硬件 
支持 , 这 需要 数 模 转换 器 支持 多 种 取样 频率 , 硬件 必须 能 够 产生 两 套 时 钟 一 一 8000 Hz 和 11025 Hz， 
这 无 疑 增加 了 硬件 成 本 。 第 二 种 办 法 就 是 硬件 只 支持 一 种 取样 频率 ， 通 过 软件 改变 声音 信号 的 
取样 频率 。 

改变 取样 频率 的 基本 方法 就 是 对 离散 的 数字 信号 进行 插值 。 插值 运算 有 多 种 算法 ,例如 拉 
格 朗 日 插值 法 、 三 阶 样 条 曲线 、 贝 赛 尔 曲线 、 线 性 插值 ， 等 等 。 这 些 算 法 在 图 形 学 领域 应 用 十 
分 广泛 ， 但 是 它们 不 能 用 来 对 数字 声音 信号 进行 插值 运算 。 

对 于 数字 声音 信号 , 我 们 关心 的 是 插值 运算 的 结果 和 原声 音信 号 的 误差 。 由 香农 定理 可 知 ， 
如 果 取 样 频率 高 于 模拟 信号 的 最 高 频率 的 两 倍 ， 就 可 以 从 取样 后 的 数字 信和 号 精确 地 恢复 原 模拟 
信号 。 因 此 最 理想 的 数字 声音 信号 的 插值 算法 就 是 基于 此 理论 ， 从 而 精确 地 恢复 原 信号 。 得 到 
原 信 号 之 后 ， 只 要 再 对 其 用 新 的 取样 频率 进行 取样 ， 就 可 以 实现 重 取样 了 。 这 种 插值 算法 被 称 
为 限 频带 插值 (Bandlimited Interpolation)。 


» http://cerma.stanford.edu/~jos/resample 
限 频 带 插值 的 原理 


假设 对 于 连续 时 间 信号 xf 进行 取样 之 后 得 到 一 个 数列 x(n7;)， 这 里 的 1 表示 连续 时 间 ，n 
是 一 个 整数 ， 而 五 是 取样 周期 。 假 设 信号 x(y) 的 频带 在 -F,/2 和 Fs/2 之 间 ，Fs 是 取样 频率 ， 即 
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Fl/Ts。 
使 用 下 面 的 公式 可 以 将 取样 数列 x(n7:) 还 原 为 原始 的 连续 时 间 信号 x(D): 


xD) = DnT nL) 


nw 


h(f) =sinc(F7)= ae 


分 析 一 下 此 公式 的 含义 。 取 样 之 后 的 数字 信号 可 以 看 做 原 模拟 信号 与 周期 是 五 的 脉冲 信号 
的 乘积 。 由 于 两 个 时 域 信号 的 乘积 ， 等 于 它们 的 频 域 信号 的 卷 积 ， 因 此 取样 之 后 信号 的 频 域 就 
是 原 信号 频谱 与 周期 脉冲 信号 的 频谱 的 卷 积 。 脉 冲 信号 转换 成 频 域 之 后 仍然 是 脉冲 ， 两 个 脉冲 
之 间 的 间隔 刚好 是 取样 频率 F,。 这 样 一 来 ， 频 域 卷 积 的 结果 就 是 原 模拟 信号 的 频谱 在 频率 轴 上 
不 断 地 重复 ， 就 好 像 时 域 中 的 周期 信号 一 样 。 

为 了 将 取样 后 的 信号 还 原 为 原 模拟 信号 ， 需 要 对 其 进行 低 通 滤 波 ， 如 果 使 用 通 带 为 -F;/2 
到 /2 的 理想 低 通 滤波 器 , 就 可 以 精确 地 得 到 原 信号 的 频谱 。 这 种 理想 低 通 滤波 器 转换 为 时 域 
波形 ， 就 是 sinc 函数 。 因 此 还 原 之 后 的 模拟 信号 可 以 看 做 取样 信号 和 sinc 函数 的 卷 积 。 或 者 可 
以 理解 为 : 在 每 个 取样 点 处 放置 一 个 sinc 函数 波形 , 最 终 的 模拟 信号 就 是 所 有 这 些 波形 的 县 加 。 
如 图 14-19 所 示 ， 数 字 信号 的 取样 周期 五 为 1，4 个 脉冲 表示 数字 信号 中 的 4 个 取样 点 ， 将 其 
还 原 为 模拟 信号 时 ， 在 每 个 取样 点 处 放置 一 个 用 虚线 表示 的 sine 函数 波形 ， 最 后 的 模拟 信号 就 
是 这 4 个 波形 的 又 加 ， 图 中 用 粗 实 线 表 示 。 由 于 sinc 函数 波形 在 每 个 取样 点 处 的 值 都 为 0， 因 
此 得 到 的 模拟 信号 正好 经 过 所 有 的 取样 点 。 


. 办 filter_resample_sinc.py 
记 。 绘制 将 数字 信号 还 原 为 模拟 信号 的 示意 图 


虽然 理论 上 可 以 把 取样 后 的 信号 还 原 为 原 信号 ,但 是 由 于 sinc 函数 波形 是 无 限 长 的 , 实际 
计算 中 ， 只 能 取 sine 函数 波形 的 一 部 分 进行 卷 积 计算 ， 并 且 需 要 使 用 窗 函 数 加 快 收敛 速度 。 


14-19 使 用 sinc 函数 将 数字 信号 还 原 为 模拟 信号 


¥# filter_resample demo.py 


过 


让 二 ” 限 频带 插值 算法 演示 
下 面 我 们 用 程序 验证 限 频 带 插值 算法 。 首 先 计算 100 点 取样 频率 为 1 Hz、 频 率 为 2x 的 
正弦 波 : 


>>> t = np.arange(6，166) 
>>> x = np.sin(t) 


由 于 计算 机 无 法 计算 真正 的 模拟 信号 , 因此 下 面 的 程序 计算 取样 频率 提高 N 倍 之 后 的 数字 
信号 。 先 计算 理想 的 信号 x2: 


>>> N = 166 
>>> t2 = np.arange(86，1986，1.6/N) 
>>> x2 = np.sin(t2) 


为 了 和 sine 函数 进行 卷 积 ， 先 将 原始 的 数字 信号 x 的 取样 频率 提高 N 倍 ，x3 中 的 每 N 个 
取样 点 中 有 一 个 是 x 中 的 取样 点 : 


>>> x3 = np.zeros(len(x)*N) 
>>> x3[::N] = x 


然后 计算 sinc 函数 波形 与 Hanning 窗 ( 汉 宁 窗 ， 又 称 升 余弦 窗 ) 乘 积 之 后 的 波形 ; 


>>> sinc = np.sinc(np.arange(-196，16，1.6/N) ) 
>>> sincw = sinc * signal.hann(len(sinc)) 


分 别 用 这 两 个 FIR 滤波 器 对 信号 x3 进行 低 通 滤波 ， 得 到 信号 x4 和 x5: 

>>> x4 = signal.1filter(sinc，[1]，x3) 

>>> x5 = signal.1filter(sincw，[1]，x3) 

为 了 和 理想 信号 x2 进行 比较 ， 移 除 掉 因 滤波 带 来 的 延 时 ; 

>>> x4 = x4[len(sinc)/2:] 

>>> x5 = x5[len(sincw)/2:] 

由 于 t<0 时 输入 波形 为 0， 因 此 滤波 计算 刚 开始 时 会 有 较 大 的 误差 ,我们 只 比较 x2 与 x4、 

x5 在 伺 10 之 后 的 误差 值 。 由 下 面 的 结果 可 知 ，x5 比 x4 更 接近 理想 波形 x2。 因 此 采用 窗 函 数 
处 理 之 后 的 sinc 波形 ， 能 更 精确 地 还 原 信 号 ， 这 和 图 14-7 中 表示 的 结果 是 一 致 的 。 


>>> np.sum((x2[16*N:98*N] - x4[19*N:98*N] )#*#2) 
1.79838668796881929 

>>> np.sum((x2[16*N:96*N] - x5[16*N:96*N])**2) 
8.66613846982681864963 
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接 下 来 请 读者 自己 完成 下 面 的 工作 : 

e 将 计算 中 出 现 的 各 种 信号 绘制 成 图 。 

e 用 各 阶 B 样 条 曲线 插值 对 x 进行 插值 ， 计 算 它们 和 x2 之 间 的 误差 。 

前 面 的 计算 步 又 只 是 用 来 演示 限 频 带 插值 算法 的 原理 ， 实 际 的 重 取样 计算 可 以 使 用 
scikits.samplerate 库 。 


© http://pypi.python.org/pypi/scikits.samplerate/0.3.1 
scikits.samplerate 库 的 下 载 地 址 


安装 好 scikits.samplerate 库 之 后 ， 运 行 下 面 的 代码 ， 对 信号 x 进行 100 倍 取样 频率 的 重 
取样 : 


>>> from scikits import samplerate 

>>> x6 = samplerate.resample(x, 160, 'sinc_best') 
>>> np.sum((x2[16*N:969*N] - x6[16*N:9@6*N])**2) 
@.893249751451539964 


其 中 , 参数 'since_best 设 置 重 取样 的 算法 和 精度 , 它 的 候选 值 可 以 通过 available_ convertors0 
获得 : 


>>> samplerate.available_convertors() 
['sinc medium', 'linear', 'sinc fastest', 'zero_order hold', 'sinc best'] 


频 域 信号 处 理 


用 FFT( 快 速 傅立叶 变换 ) 能 将 时 域 的 数字 信号 转换 为 频 域 信号 。 转 换 为 频 域 信号 之 后 ， 可 
以 很 方便 地 分 析出 信号 的 频率 成 分 ， 在 频 域 上 进行 处 理 ， 最 终 还 可 以 将 处 理 完毕 的 频 域 信号 通 
过 IFFT( 快 速 传 立 叶 变 换 的 逆 变 换 ) 转 换 回 时 域 信号 ,实现 许多 在 时 域 无 法 完成 的 信号 处 理 算法 。 
本 章 将 通过 许多 实例 ， 介 绍 有 关 频 域 信号 处 理 的 一 些 基础 知识 。 


15.1 FFT 演示 程序 


本 节 介绍 如 何 使 用 NumPy、Traits 以 及 Chaco 等 库 , 编写 一 个 三 角 波 的 FFT 演示 程序 。 此 
程序 演示 了 如 何 综合 使 用 各 种 库 , 编写 带 界面 的 科学 计算 程序 , 并 且 可 以 帮助 读者 理解 FFT 的 
原理 。 


15.1.1 FFT 知识 复习 


在 正式 开始 程序 编写 之 前 ， 首 先 让 我 们 复习 一 下 有 关 FFT 变换 的 知识 。 

FFT 变换 是 针对 一 个 数组 的 运算 , 数组 的 长 度 NN 通常 是 2 的 整数 次 宕 ,例如 64、128、256 
等 。 数 值 可 以 是 实数 或 复数 ， 通 常 的 时 域 信号 都 是 实数 ， 因 此 下 面 都 以 实数 为 例 。 我 们 可 以 把 
这 一 组 实数 想象 成 对 某 个 连续 信号 按照 一 定 取样 周期 进行 取样 而 得 , 如 果 对 有 N 个 实数 的 数组 
进行 FFT 变换 ， 将 得 到 一 个 含有 N 个 复数 的 数组 ， 我 们 称 此 复数 数组 为 频 域 信 号 ， 它 的 元 素 
有 如 下 规律 : 

e 下 标 为 0 和 N/2 的 两 个 复数 的 虚数 部 分 为 0。 

。 下 标 为 1 和 N-i 的 两 个 复数 共 斩 ， 也 就 是 其 虚数 部 分 数值 相同 、 符 号 相反 。 

下 面 的 例子 演示 了 上 述 规律 ， 先 以 rand0 随 机 产生 含有 8 个 元 素 的 数组 x， 然 后 用 住 0 对 
其 运算 之 后 ， 观 察 到 结果 为 8 个 复数 ， 并 且 满 足 上 面 两 条 规律 ; 


>>> x = np.random.rand(8) 

>>> x 

array([ 6.15562699， 8.56862756， 6.54371949， 8.96354358， 8.66678158， 
8.78366968， 6.98116887， 6.1588846 ]) 

>>> xf = np.fft.fft(x) 

>>> xf 

array([ 3.78195634+6.j ，-8.53575962+0.57688897j， 
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-0.68248579-1.12988986j，-8.36656155-8.13881778j， 
8@.63262552+8.j ， -0.36656155+8.13881778j， 
-0.68248579+1.129886986j，-98.53575962-8.57688897j]) 


FFT 变换 的 结果 可 以 通过 IFFT 变换 还 原 为 原来 的 值 : 


>>> np.fft.ifft(xf) 

array([ 6.15562699 +0.0600000006e+00j， 8.56862756 +1.91946662e-16j， 
8.54371949 +1.24966696e-16j， 8.66354358 -2.33573365e-16]j， 
8.66678158 +6.66666666e+86j， 9.78368968 +2.75266729e-16]j， 
8.96116887 -1.24966696e-16j， 68.15888466 -2.33573365e-16j]) 


注意 ，iffi0 的 运算 结果 实际 上 和 数组 x 是 相同 的 ， 由 于 浮 点 数 有 运算 误差 ， 因 此 出 现 了 一 
些 非常 小 的 虚数 ， 如 果 有 必要 ， 可 以 调用 np real0 获 取 其 中 的 实数 部 分 。 

FFT 变换 和 IFFT 变换 并 没有 增加 或 减少 数据 的 个 数 : 数组 x 中 有 8 个 实数 数值 ， 而 数组 
xf 中 其 实 也 只 有 8 个 有 效 的 数值 。 


计算 FFT 结果 中 有 用 的 数值 
由 于 复数 共 力 和 虚数 部 分 为 0 等 规律 ,真正 有 用 的 信息 保存 在 下 标 从 0 到 N/2 的 N/2+1 
个 复数 中 ， 又 由 于 下 标 为 0 和 N/2 的 值 虚数 部 分 为 0， 因 此 只 有 NN 个 有 效 的 数值 。 


下 面 看 看 FFT 变换 所 得 到 的 复数 的 含义 : 

。 下 标 为 0 的 实数 表示 了 时 域 信号 中 的 直流 成 分 。 

e， 下 标 为 i 的 复数 atb*j 表示 时 域 信号 中 周期 为 Vi 个 取样 值 的 正弦 波 和 余弦 波 的 成 分 ， 
其 中 a 表示 余弦 波 的 成 分 ，b 表示 正弦 波 的 成 分 。 

下 面 让 我 们 通过 几 个 例子 验证 一 下 ， 首 先 对 一 个 直流 信号 进行 FFT 变换 : 


>>> x = np.ones(8) 
>>> X 
Pay Den 13 ET 
>>> np.fft.fft(x)/len(x) # 为 了 计算 各 个 成 分 的 能 量 多 少 ， 需 要 将 FFT 的 结果 除 以 FFT 的 长 度 
array([ 1.+6.j， 86.+6.j， 8.+6.j，8.+6.j，8.+6.j，68.+6.j，6.+6.j， 
9.+6.j]) 


所 谓 直流 信号 ， 就 是 其 值 不 随时 间 变 化 ， 因 此 我 们 创建 一 个 值 全 为 1 的 数组 x， 可 以 看 到 
它 的 FFT 结果 除了 下 标 为 0 的 数值 不 为 0 以 外 ， 其 余 的 都 为 0。 这 表示 时 域 信 号 是 直流 的 ， 并 
且 其 能 量 为 1。 

下 面 我 们 产生 一 个 周期 为 8 个 取样 的 正弦 波 ， 然 后 观察 其 FFT 结果 : 


>>> x = np.arange(0, 2*np.pi, 2*np.pi/8) 
>>> y = np.sin(x) 


>>> tmp = np.fft.fft(y)/len(y) 
>>> print np.array_str(tmp, suppress_small=True) 
[ 8.+6.j -6.-6.5j 8.-6.j 8.-8.j 8.+6.j 8.-6.j 8.+6.j 8.+6.5j] 


如 何 用 linspace 创建 取样 点 
要 计算 周期 为 8 个 取样 的 正弦 波 ， 就 需要 把 0 到 2z 的 区 间 等 分 为 8 份 ， 如 果 直 接 用 
linspace0， 它 产生 的 值 为 : 


>>> np.linspace(8, 2*np.pi, 8) 

array([ 8. » 0.8975979 ， 1.7951958 ， 2.6927937 ， 3.5983916 ， 
4.48798951， 5.38558741， 6.28318531]) 

>>> 2*np.pi / 6.8975979 

7.9666666679986666 


可 以 看 出 ,程序 只 将 0 到 2r 的 区 间 等 分 为 7 份 。 为 了 获得 正确 的 结果 ， 可 以 产生 9 个 
点 ， 并 设置 endpoint 参数 为 False， 最 终结 果 将 不 包括 最 后 的 点 : 


>>> np.linspace(8, 2*np.pi, 9, endpoint=False) 
array([ 8. ， 6.6981317 ， 1.3962634 ， 2.6943951 ， 2.7925268 ， 
3.4986585 ， 4.1887962 ， 4.88692191, 5.58565361]) 


为 了 便于 观察 结果 ， 我 们 用 array_str0 将 数组 转换 字符 串 ， 并 设置 suppress_small 参数 为 
Tme， 将 一 些 很 小 的 数值 显示 为 0。 现在 观察 正弦 波 的 FFT 计算 结果 : 下 标 为 1 的 复数 的 虚数 
部 分 为 -0.5， 而 我 们 产生 的 正弦 波 的 振幅 为 1， 它 们 之 间 的 关系 是 -0.5*(-2)=1。 接 下 来 观察 余 
弦 信号 的 FFT 结果 : 


>>> tmp = np.fft.fft(np.cos(x))/len(x) 
>>> print np.array_str(tmp, suppress_small=True) 
[-0.0+0.j] 8.5-0.j] 90.0+0.j] 0.6+0.j] 6.6t6.j -9.6+6.j 8.6+0.j] 8.5-9.j] 


只 有 下 标 为 1 的 复数 的 实数 部 分 为 0.5， 和 余弦 波 振幅 之 间 的 关系 是 0.5*2=1。 再 看 下 面 两 
个 例子 : 


>>> tmp = np.fft.fft(2*np.sin(2*x))/len(x) 

>>> print np.array_str(tmp, suppress_small=True) 

[ 9.+6.j 0.+0.j -0.-1.j 6.-6.j 0.1+0.j 86.+6.j -86.+1.j 98.-6.j] 

>>> tmp = np.fft.fft(0.8*np.cos(2*x))/len(x) 

>>> print np.array_str(tmp, suppress_small=True) 

[-8.0+0.j -9.6+6.j 6.4-6.j 6.6-6.j 8.60+0.j] 86.6-6.j 8.4+8.j -90.0+0.j] 


上 面 产生 的 是 周期 为 4 个 取样 点 的 正弦 和 余弦 信号 ,其 FFT 的 有 效 成 分 在 下 标 为 2 的 复数 
中 ， 其 中 正弦 波 的 振幅 为 2， 其 频 域 虚数 部 分 的 值 为 -1; 余弦 波 的 振幅 为 0.8， 频 域 中 对 应 的 值 
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为 0.4。 

如 果 将 两 个 同 频率 的 正弦 波 和 余弦 波 通过 不 同 的 系数 进行 倒 加 , 就 可 以 得 到 同样 频率 的 各 
种 相位 的 余弦 波 。 因 此 我 们 可 以 这 样 来 理解 频 域 中 的 复数 : 

。 复数 的 模 (绝对 值 ) 的 两 倍 为 对 应 频率 的 余弦 波 的 振幅 。 

。 复数 的 辐 角 表示 对 应 频率 的 余弦 波 的 相位 。 

最 后 再 看 一 个 例子 : 


>>> x = np.arange(@, 2*np.pi, 2*np.pi/128) 

>>> y = 9.3+np.cos(x) + @.5*np.cos(2*x+np.pi/4) + 8.8*np.cos(3*x-np.pi/3) 
>>> yf = np.fft.fft(y)/len(y) 

>>> print np.array_str(yf[:4], suppress_small=True) 

[ 8.68666666+6.j ”8.1566686+6.j 8.1767767+6.1767767j ”8.2686688-8.34641616j] 


>>> np.abs(yf[1])，np.rad2deg(np.angle(yf[1])) # 周期 为 128 取样 点 的 余弦 波 的 振幅 和 相位 
(8.156666666666686688，2.3986988876246962e-615) 


>>> np.abs(yf[2])，np.rad2deg(np.angle(yf[2])) # 周期 为 64 取样 点 的 余弦 波 的 振幅 和 相位 
(8.256666666666686611，44.999999999999993) 


>>> np.abs(yf[3]), np.rad2deg(np.angle(yf[3])) # 周期 为 42.66 取样 点 的 余弦 波 的 振幅 和 相位 
(8.39999999999999991，-68.6866686668866668685) 


这 里 np.angle0 计 算 复数 的 辐 角 ， 它 得 到 的 是 弧度 ， 通 过 np.rad2deg0 将 弧度 变换 为 角度 。 
在 这 个 例子 中 我 们 产生 了 3 个 频率 、 振 幅 和 相位 各 不 相同 的 余弦 波 : 

e 周期 为 128 个 取样 点 的 余弦 波 的 相位 为 0， 振幅 为 0.3。 

e 周期 为 64 个 取样 点 的 余弦 波 的 相位 为 45 度 ( /4)， 振 幅 为 0.5。 

e 周期 为 42.66(128/3.0) 个 取样 点 的 余弦 波 的 相位 为 -60(- /3) 度 ， 振 幅 为 0.8。 

对 照 yf[1]、yf[2]、yf[3] 的 复数 振幅 和 辐 角 ， 读 者 应 该 对 FFT 结果 中 的 每 个 数值 有 了 很 清 


晰 的 理解 。 


FFT 的 运算 效率 


FFT 的 运算 效率 由 FFT 长 度 N 的 质 因子 决定 ，N 能 被 分 解 得 越 小 则 运算 速度 越 快 。 例 
如 , 当 N 为 素数 时 , FFT 的 运算 效率 达到 最 低 。 下 面 的 程序 比较 4096 点 FFT 和 4093 点 FFT 
运算 的 时 间 ， 由 于 4096 是 2 的 整数 次 寡 ， 而 4093 是 一 个 素数 ， 因 此 它们 的 运算 时 间 相差 非 
常 大 : 


>>> timeit.timeit("np.fft.fft(x)", 


... "import numpy as np;x=np.random.random(4696)", number=166) 
8@.01888219968655136 


>>> timeit.timeit("np. fft.fft(x)", 


... "import numpy as np;x=np.random.random(4693)"，number=166) 
6.6385661768412261 


15.1.2 “合成 时 域 信号 


在 15.1.1 节 的 演示 中 ， 通 过 iffi0 可 以 将 频 域 信号 转换 回 时 域 信号 ,这 种 转换 是 精确 的 。 下 
面 的 程序 完成 类 似 的 频 域 信号 转 时 域 信号 的 计算 。 不 过 可 以 由 用 户 选 择 一 部 分 频 域 信号 转换 为 
时 域 信号 ， 这 样 转换 的 结果 和 原始 的 时 域 信号 会 有 误差 ， 通 过 观察 可 以 发 现 使 用 的 频率 信息 越 
多 ， 此 误差 越 小 。 通 过 此 程序 可 以 直观 地 观察 到 多 个 余弦 波 的 又 加 是 如 何 逐 步 副 近 任意 的 时 域 
信号 的 ， 图 15-1 显示 了 使 用 FFT 计算 的 三 角 波 频谱 。 


a 人 example_ triangle.py 
使 用 FFT 计算 三 角 波 的 频谱 


import numpy as np 
import pylab as pl 


# 产生 size 点 取样 的 三 角 波 ， 周 期 为 1 
def triangle wave(size): © 
x = np.arange(6，1，1.6/size) 
y = np.where(x<8.5，x，9) 
y = np.where(x>=8.5，1-x，y) 
return x，y 


# 取 FFT 计算 结果 freqs 中 的 前 n 项 进行 合成 ， 返 回合 成 结果 ， 计 算 loops 个 周期 的 波形 
def fft_combine(freqs, n, loops=1): © 
length = len(freqs) * loops 
data = np.zeros(length) 
index = loops * np.arange(0, length, 1.0) / length * (2 * np.pi) 
for k, p in enumerate(freqs[:n]): 
if k != 6: p *= 2 # 除去 直流 成 分 之 外 ， 其 余 的 系数 都 乘 以 2 
data += np.real(p) * np.cos(k*index) # 余弦 成 分 的 系数 为 实数 部 分 
data -= np.imag(p) * np.sin(k*index) # 正弦 成 分 的 系数 为 负 的 虚数 部 分 


return index, data 
fft_size = 256 


# 计算 三 角 波及 其 FFT 结果 
x, y = triangle wave(fft_size) 
fy = np.fft.fft(y) / fft_size 


# 绘制 三 角 波 的 FFT 的 前 28 项 的 振幅 ， 由 于 不 含 下 标 为 偶数 的 值 均 为 69。 因此 取 

# 1og 之 后 无 穷 小 ， 无 法 绘图 ， 用 np.clip 函数 设置 数组 值 的 上 下 限 ， 保 证 绘图 正确 
pl.figure() 
pl1.plot(np.clip(29*np.log16(np.abs(fy[:26]))，-1286，126)，"o") 
pl.xlabel(u" 频 率 窗口 (frequency bin)") 

pl.ylabel(u" 幅 值 (dB)") 
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# 绘制 原始 的 三 角 波 和 用 正弦 波 逐 级 合成 的 结果 ， 使 用 取样 点 作为 x 轴 坐 标 

pl.figure() 

pl.plot(y，label=u" 原 始 三 角 波 "，l1inewidth=2) 

OP In [0 3 35 79] 
index，data = fft_combine(fy，i+1，2) # 计算 两 个 周期 的 合成 波形 
pl.plot(data, label = "N=%s" % i) 

pl.legend() 

pl.show() 


用 二 (dB) 
1 
8 


5 15 好 


38 
频 电 酉 门人 (frequency bin) 
图 15-1 三 角 波 的 频谱 


图 15-2 显示 使 用 频谱 中 的 部 分 频率 重新 合成 的 三 角 波 ( 见 文 前 彩 插 )。 由 此 图 可 知 ,合成 时 
域 信 号 时 ， 使 用 的 频率 越 多 ， 波 形 越 接近 原始 的 三 角 波 。 


15-2 ”使 用 频谱 中 的 部 分 频率 重建 的 三 角 波 


@triangle_ wave() 产 生 一 个 周期 的 三 角 波 , 这 里 使 用 np.where0 计 算 区 间 函 数 的 值 。 triangleO 
返回 两 个 数组 ,分 别 表 示 x 轴 和 y 轴 的 值 。 注 意 后 面 的 计算 和 绘图 不 使 用 x 轴 坐 标 ， 而 是 直接 
用 取样 次 数 作为 x 轴 坐 标 。 

@fft_combine0 使 用 FFT 结果 freqs 中 的 前 n 个 数据 重新 合成 时 域 信号 ，loops 参数 指定 计 
算 的 周期 数 。 

接 下 来 再 看 看 方 波 信号 。 由 于 方 波 的 波形 中 存在 跳 变 ， 因 此 用 有 限 个 正弦 波 合成 的 方 波 在 
跳 变 处 会 出 现 抖动 现象 ， 如 图 15-3 所 示 ， 用 正弦 波 合成 的 方 波 的 收敛 速度 比 三 角 波 慢 很 多 ( 见 


文 前 彩 插 )。 下 面 是 计算 方 波 波形 的 函数 : 


于 ff example rectanglepy 
总 使 用 FFT 计算 方 波 的 频谱 


def square wave(size): 
x = np.arange(@, 1, 1.8/size) 
y = np.where(x<8.5, 1.0, 8) 
return x, y 


ed 
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图 15-3 ”使 用 正弦 波 合成 的 方 波 在 跳 变 处 出 现 拉动 


15.1.3 三 角 波 FFT 演示 程序 


最 后 让 我 们 完成 三 角 波 的 FFT 演示 程序 , 使 用 它 可 以 交互 式 地 观察 各 种 三 角 波 的 频谱 以 及 
正弦 合成 的 近似 波形 。 制 作 界 面 是 一 件 很 费 工 夫 的 事情 ， 幸 好 有 TraitsUI 库 的 帮忙 ， 不 到 200 
行 代码 就 可 以 制作 出 如 图 15-4 所 示 的 效果 了 。 在 此 界面 中 ,“ 波 形 宽度 ”等 几 个 控件 是 一 种 特 
殊 的 数值 编辑 器 ， 可 以 单 击 之 后 直接 输入 数值 ， 也 可 以 用 鼠标 左 键 左右 拖 动 改变 其 数值 。 


FFT 
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图 15-4 三 角 波 频谱 观察 器 界面 
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a ff triangle GULpy 
三 角 波 FFT 演示 程序 


程序 中 已 经 给 出 了 详细 的 注释 ， 相 信 读 者 能 够 读 懂 并 掌握 这 类 程序 的 写法 。 
1S.2 ”观察 信号 的 频谱 


将 时 域 信号 通过 FFT 转换 为 频 域 信号 之 后 , 将 其 各 个 频率 分 量 的 幅 值 绘制 成 图 , 便 能 很 直 
观 地 观察 信号 的 频谱 。 下 面 的 程序 可 完成 这 一 任务 : 


型 spectrum full period.py 
整数 个 周期 的 正弦 波 频谱 


import numpy as np 
import pylab as pl 


sampling_rate, fft_size = 8666，512 @ 

t = np.arange(9, 1.0, 1.8/sampling rate) © 

x = np.sin(2*np.pi*156.25*t) + 2*np.sin(2*np.pi*234.375*t) © 
xs = x[:fft_size] 

xf = np.fft.rfft(xs)/fft_size @ 

freqs = np.linspace(0, sampling rate/2, fft_size/2+1) © 
xfp = 26*np.logl6(np.clip(np.abs(xf)，le-26，1lel166)) © 
pl.figure(figsize=(8,4)) 

pl.subplot(211) 

pl.plot(t[:fft_size], xs) 

pl1.xlabel(u" 时 间 ( 秒 )") 

pl.subplot(212) 

pl.plot(freqs, xfp) 

pl.xlabel(u" 频 率 (Hz)") 

pl.subplots_adjust(hspace=0.4) 

pl.show() 


@ 首 先 定义 了 两 个 常数 一 -sampling rate 和 值 size， 分 别 表 示 数 字 信号 的 取样 频率 和 FEFT 
的 长 度 。@ 然 后 调用 np.arange0 产 生 1 秒 钟 的 取样 时 间 ,t 中 的 每 个 数值 直接 表示 取样 点 的 时 间 ， 
因此 其 间隔 为 取样 周期 sampline rate。 

上 @ 用 取样 时 间 数 组 t 可 以 很 方便 地 计算 出 波形 数据 ， 这 里 计算 的 是 两 个 正弦 波 的 又 加 ， 一 
个 频率 是 156.25 Hz, 一 个 是 234.375 Hz。 为 什么 选择 这 两 个 奇怪 的 频率 呢 ? 因为 这 两 个 频率 的 
正弦 波 在 512 个 取样 点 中 正好 有 整数 个 周期 。 只 有 整数 个 周期 的 波形 的 FFT 结果 能 精确 地 反映 


其 频率 。 


N 点 FFT 能 精确 计算 的 频率 

假设 取样 频率 为 上 , 取 波 形 中 的 Y 个 数据 进行 FFT 变换 。 那 么 当 这 六 个 数据 包含 整数 个 
周期 的 波形 时 ，FFT 计算 的 结果 是 精确 的 。 于 是 能 精确 计算 的 波形 的 周期 是 nf /NN 。 对 于 
8k Hz 的 取样 频率 、512 点 的 FFT 来 说 ，8000/512.0 = 15.625 Hz， 即 只 能 精确 表示 15.625 Hz 
的 整数 倍 频率 。156.25 Hz 和 234.375 Hz 正好 是 其 10 倍 和 15 倍 。 


@ 这 里 我 们 使 用 rtt0 对 从 波形 数据 x 中 截取 的 住 size 个 取样 点 进行 FFT 计算 ， 得 到 的 结 
果 不 包括 共 轿 部分。 根据 FFT 计算 公式 ， 为 了 正确 显示 波形 能 量 ， 还 需要 将 结果 除 以 FFT 的 
长 度 认 size。 

对 于 长 度 为 N 的 FFT 运算 ,rfft0 返 回 N/2+1 个 复数 , 分 别 表示 从 0 Hz 到 (sampling rate/2) Hz 
的 N/2+1 点 频率 的 成 分 ,@ 因 此 可 以 通过 linspace0 计 算出 rfR0 的 返回 值 中 每 个 数值 对 应 的 真正 
频率 。 

@ 最 后 计算 每 个 频率 分 量 的 幅 值 , 并 将 其 转换 为 以 dB 度量 的 值 .为 了 防止 0 幅 值 造成 log100 
无 法 计算 ， 我 们 调用 np.clip0 对 xf 的 幅 值 进行 上 下 限 处 理 。 

剩 下 的 程序 将 时 域 波形 和 频 域 波形 绘制 成 如 图 15-5 所 示 的 图 表 。 


mr 


训 B03 日 ,有 7 


15-5 156.25 Hz 和 234.375 Hz 的 波形 (上 ) 和 频谱 (下 ) 
如 果 放 大 频谱 中 的 两 个 峰值 ， 就 可 以 看 到 其 值 分 别 为 : 


>>> xfp[16] 
-6.9265999132796251 

>>> xfp[15] 
-9.6432746655328714e-16 


即 156.25 Hz 的 幅 值 大 小 为 -6 dB， 而 234.375 Hz 的 幅 值 大 小 为 0 dB。 
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下 面 我 们 看 看 非 整数 个 周期 的 波形 的 频谱 ， 将 波形 计算 公式 修改 为 : 
x = np.sin(2*np.pi*260*t) + 2*np.sin(2*np.pi*366*t) 
得 到 的 结果 如 图 15-6 所 示 。 


x # spectrum part period.py 
六 二 非 整数 周期 的 正弦 波 的 频谱 


Wi EE 
生计 (Pr) 


图 15-6 非 完整 周期 (200 Hz 和 300 Hz) 的 正弦 波 经 过 FFT 变换 之 后 出 现 频谱 泄漏 


这 次 得 到 的 频谱 不 再 是 两 个 完美 的 峰值 ， 而 是 两 个 峰值 频率 周围 的 频率 都 有 能 量 ,这 显然 
和 两 个 正弦 波 的 又 加 波形 的 频谱 有 区 别 。 本 来 应 该 属于 200 Hz 和 300 Hz 的 能 量 分 散 到 了 周围 
的 频率 中 ， 这 个 现象 被 称 为 频谱 泄漏 。 出 现 频谱 泄漏 的 原因 在 于 伺 size 个 取样 点 无 法 放下 整 


数 个 200 Hz 和 300 Hz 的 波形 。 
频谱 泄漏 的 解释 
我 们 只 能 在 有 限 的 时 间 段 中 对 信和 号 进行 测量 ， 无 法 知道 测量 范围 之 外 的 信号 。 因 此 只 能 
对 测量 范围 之 外 的 信号 进行 假设 。 而 傅立叶 变换 的 假设 很 简单 :测量 范围 之 外 的 信号 是 所 测 
量 到 的 信号 的 重复 。 
现在 考虑 512 点 FFT， 从 信号 中 取出 的 512 个 数据 就 是 FFT 的 测量 范围 ， 它 计算 的 是 这 
512 个 数据 一 直 重 复 的 波形 的 频谱 。 显 然 如 果 512 个 数据 包含 整数 个 周期 ， 那 么 得 到 的 结果 就 
是 原始 信号 的 频谱 ， 而 如 果 不 是 整数 个 周期 ， 得 到 的 频谱 就 是 如 图 15-7 的 波形 的 频谱 ， 图 中 的 
波形 是 用 8k Hz 的 取样 频率 采集 的 512 点 的 50 Hz 的 正弦 波 不 断 重 复 的 结果 。 


Spectrum 50 HzRepeat.py 
六 计算 50 Hz 正弦 波 的 512 点 取样 的 重复 波形 


>>> t = np.arange(6，1.96，1.6/8666) 
>>> x = np.sin(2*np.pi*5@*t)[:512] 
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>>> pl.plot(np.hstack([x,x,x])) 
>>> pl.show() 
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图 15-7 50 Hz 正弦 波 的 512 点 FFT 所 计算 的 频谱 的 实际 波形 


由 于 波形 的 前 后 不 是 连续 的 , 存在 跳 变 ,而 跳 变 处 有 着 非常 广泛 的 频谱 ,因此 FFT 结果 中 
将 出 现 频谱 泄漏 。 


15.2.1 窗 函 数 


为 了 减少 FFT 所 截取 的 数据 段 前 后 的 跳 变 , 可 以 让 数据 先 乘 以 一 个 窗 函 数 , 使 得 其 前 后 数 
据 能 平滑 过 渡 。 例 如 ， 常 用 的 Hann 窗 函 数 的 定义 如 下 : 


wm) =0.50 cos ) 
其 中 N 为 窗 函 数 的 点 数 ， 图 15-8 是 一 个 512 点 Hann 窗 的 曲线 。 


spectrum hann window.py 
完了 绘 制 512 点 Hann 窗 函 数 


>>> import pylab as pl 


>>> import scipy.signal as signal 
>>> pl.figure(figsize=(8,3)) 
>>> pl.plot(signal.hann(512)) 


15-8 ”Hann 窗 函 数 
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窗 函数 都 在 scipy.signal 库 中 定义 ， 它 们 的 第 一 个 参数 为 点 数 N。 可 以 看 出 ，Hann 窗 函 数 
是 完全 对 称 的 ， 也 就 是 说 第 0 点 和 第 511 点 的 值 完 全 相同 ， 都 为 0。 如 果 将 这 样 的 窗 函 数 与 信 
号 数据 相 乘 ， 然 而 进行 重复 ， 结 果 中 会 出 现 前 后 两 个 连续 的 0， 这 会 对 FFT 变换 之 后 的 信号 频 
谱 有 一 定 的 影响 。 

为 了 解决 连续 0 值 的 问题 ，Hann 窗 函 数 提供 了 sym 参数 ， 如 果 它 的 值 为 0， 将 产生 一 个 
N+1 点 的 Hann 窗 函 数 ， 并 舍 去 最 末 的 数值 ， 这 样 得 到 的 窗 函 数 适合 于 周期 信号 : 


>>> signal.hann(8) 


array([ 6. ， 8.1882551 ， 9.61126647， 8.95648443， 8.95648443， 
68.61126647， 89.1882551 ， 6. ]) 

>>> signal.hann(8，sym=6) 

array([ 8. ， 6.14644661， 6.5 ， 8.85355339， 1. 
@.85355339, 6.5 ， 8.14644661]) 


50 Hz 正弦 波 与 窗 函 数 相 乘 之 后 的 周期 重复 波形 如 图 15-9 所 示 。 


A spectrum 50 HzRepeat hann.py 
守 计 算 50Hz 正弦 波 与 窗 函 数 的 乘积 


>>> 七 = np.arange(6，1.96，1.6/8666) 

>>> x = np.sin(2*np.pi*5@*t)[:512] * signal.hann(512，sym=6) 
>>> pl.plot(np.hstack([x,x,x])) 

>>> pl.show() 
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15-9 加 Hann 窗 的 50 Hz 正弦 波 的 512 点 FFT 所 计算 的 实际 波形 


回 到 前 面 的 例子 ， 将 200 Hz 和 300 Hz 的 又 加 波形 与 Hann 窗 相 乘 之 后 再 计算 其 频谱 ， 得 
到 如 图 15-10 的 频谱 图 ( 见 文 前 彩 插 )。 


a spectrum hann 全 .py 
使 用 Hann 窗 降低 非 整 数 周期 的 信号 的 频率 泄漏 


A 人 


9 158 265 2ZS 3899 358 


[ Seo le 1588 2088 2508 36%0 35868 0 
频 曲 {Hz) 


15-10 加 Hann 窗 前 后 的 频谱 ，Hann 窗 能 降低 频谱 泄漏 


可 以 看 到 ， 与 Hann 窗 相 乘 之 后 的 信号 的 频谱 能 量 更 加 集中 于 200 Hz 和 300 Hz， 但 是 其 
能 量 有 所 降低 。 这 是 因为 Hann 窗 本 身 有 一 定 的 能 量 衰减 : 


>>> np.sum(signal.hann(512，sym=6))/512 
@.5 


因此 ， 如 果 需 要 严格 保持 信号 的 能 量 ， 还 需要 在 乘 以 Hann 窗 之 后 再 把 信号 扩大 一 倍 。 
15.2.2 ”频谱 平均 


对 于 频谱 特性 不 随时 间 变 化 的 信号 ,例如 引擎 、 压 缩 机 等 机 器 噪声 ， 可 以 对 其 进行 长 时 间 
的 采样 ,然后 分 段 进行 FFT 计算 ,最 后 对 每 个 频率 分 量 的 幅 值 求 平均 值 , 便 可 以 准确 地 测量 信 
号 的 频谱 。 

下 面 的 程序 可 完成 这 一 计算 : 


A spectrum average_whitenoise.py 
高 计算 白 噪声 的 平均 频谱 


def average fft(x, fft_size): 
n = len(x) // fft_size * fft_size 
tmp = x[:n].reshape(-1, fft_size) © 
tmp *= signal.hann(fft_size, sym=0) © 
xf = np.abs(np.fft.rfft(tmp)/fft_size) © 
avgf = np.average(xf, axis=0) @ 
return 269xnp.1og16(avgf) 


average_fft(x, ff size) 对 数组 x 进行 值 size 点 FFT 运算 , 并 返回 以 dB 为 度量 的 平均 幅 值 。 
由 于 x 的 长 度 可 能 不 是 从 _size 的 整数 倍 ，@ 因 此 首先 将 其 缩短 为 伺 size 的 整数 倍 ， 然 后 用 
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reshape() 将 其 转换 成 一 个 二 维 数组 tmp。tmp 的 第 1 轴 的 长 度 为 角 _size。 

@ 将 tmp 数组 第 1 轴 上 的 数据 和 Hann 窗 相 乘 .@ 调 用 rffi0 对 tmp 数组 的 每 行 数据 进行 FFT 
计算 ， 并 求 幅 值 。@ 最 后 ， 用 average0 对 xf 沿 着 第 0 轴 进 行 平均 ， 这 样 就 得 到 每 个 频率 分 量 的 
平均 幅 值 。 

15-11 是 利用 average_ 全 0 计算 随机 数 序列 频谱 的 例子 。 


>>> x = np.random.rand(166666) - 9.5 
>>> xf = average fft(x, 512) 

>>> pl.plot(xf) 

>>> pl.show() 


a Se 1 158 286 258 
拔 昌 窗口 (frequency Bin) 


图 15-11 白 噪声 的 频谱 接近 水 平 直线 (注意 Y 轴 的 范围) 


可 以 看 到 随机 噪声 的 频谱 接近 一 条 水 平 的 直线 ， 也 就 是 说 每 个 频率 窗口 的 能 量 都 相同 ， 这 
种 噪声 被 称 为 白 噪声 。 

如 果 我 们 让 白 噪声 通过 一 个 IIR 低 通 滤波 器 ， 绘 制 其 输出 信号 的 平均 频谱 ， 就 能 够 观察 到 
JIR 滤波 器 的 频率 响应 特性 .下 面 的 程序 利用 iirdesign0 设 计 一 个 8k Hz 取样 的 ]k Hz 的 Chebyshev 
I 型 低 通 滤波 器 ,iirdesign0 需 要 用 正规 化 的 频率 ( 取 值 范围 为 0 到 1), 然后 调用 ftfilt0 对 白 噪声 
信号 x 进行 低 通 滤波 : 

琵 Spectrum average lowpass.py 
计算 经 过 低 通 滤波 器 的 白 噪声 的 频谱 


>>>》b,a=signal.iirdesign(1666/4666.96，1266/4666.96，1，-486，6,， "cheby1") 
>>> x = np.random.rand(166666) - 9.5 
>>> y = signal.filtfilt(b, a, x) 


如 果 用 average_fR0 计 算 输 出 信号 y 的 平均 频谱 ， 将 得 到 如 图 15-12 所 示 的 频谱 图 。 


S69 1868 1568 2868 2589 26060 3568 48 昭 
频率 (hz) 


图 15-12 经 过 低 通 滤波 器 的 白 噪声 的 频谱 


15.2.3 谱 图 


虽然 使 用 FFT 能 够 观察 信号 的 频 域 特性 , 但 是 却 完全 丧失 了 信和 号 在 时 间 轴 上 的 信息 。 因此 
前 面 介绍 的 观察 信号 频谱 的 方法 只 适合 于 频率 特性 不 随时 间 变 化 的 情况 。 当 信号 频率 随时 间 变 
化 时 ， 为 了 既 能 观察 信号 频率 又 能 观察 其 随时 间 的 变化 ， 可 以 使 用 短 时 距 傅立叶 变换 (STFT)。 

使 用 STFT 算法 得 到 的 结果 被 称 为 谱 图 (Spectrogram)。 谱 图 的 横 轴 表示 时 间 ， 纵 轴 表 示 频 
率 ， 谱 图 上 每 点 的 值 表 示 信号 在 此 点 的 能 量 。STFT 算法 其 实 很 简单 :对 信号 分 段 进行 FFT 处 
理 ， 每 一 次 处 理 的 结果 都 是 谱 图 中 的 一 列 。 每 段 信号 的 长 度 越 短 ， 则 时 间 轴 上 的 精度 越 高 ， 而 
频率 轴 上 的 精度 却 越 低 , 反 过 来 也 是 一 样 。 时 间 轴 和 频率 轴 上 的 分 辩 率 是 一 对 不 可 调和 的 矛盾 ， 
根据 傅立叶 变换 的 不 确定 原理 ， 我 们 不 能 指望 同时 获得 频率 和 时 间 的 高 分 辩 率 。 

下 面 的 程序 用 于 绘制 频率 扫描 波 的 谱 图 ， 效 果 如 图 15-13 所 示 ( 见 文 前 彩 插 )。 通 过 此 图 可 
以 很 直观 地 观察 到 信号 的 频率 随 着 时 间 而 逐渐 变 高 ， 并 且 是 呈 指 数 增长 的 。 


3 # spectrogram sweep.py 
全 < 绘制 频率 扫描 波 的 谱 图 


import scipy.signal as signal 

import pylab as pl 

import numpy as np 

from numpy.1ib.stride tricks import as_strided 


sampling_rate = 8666.6 
fft_size = 1624 

step = fft_size/16 © 
time = 2 


@ 英文 全 称 为 Short-time Fourier transform。 
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t = np.arange(8, time, 1/sampling rate) 

sweep = signal.chirp(t, f6=166, t1= time, f1=6.8*+sampling_rate/2, method="logarithmic") 
number = (len(sweep)-fft size)/step ©@ 

data = as_strided(sweep, shape=(number, fft_size), strides=(step*8, 8)) © 


window = signal.hann(fft_size) @ 
data = data * window 


spectrogram = np.abs(np.fft.rfft(data, axis=1)) © 
spectrogram /= fft_size/2 
np.1og16(spectrogram，spectrogram) 

spectrogram *= 20.0 


pl.figure(figsize=(8,4)) 

im = pl.imshow(spectrogram.T, origin = "lower", 
extent=[8, 2, 8, sampling_rate/2], aspect="'auto') @ 

bar = pl.colorbar(im, fraction=8.85) 

bar.set_label(u" 能 量 (dB)") 

pl.xlabel(u" 时 间 ( 秒 )") 

pl.ylabel(u" 频 率 (Hz)") 


pl.show() 
80 
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遇见 ( 妙 ] 
图 15-13 ”频率 扫描 波 的 谱 图 


@ 为 了 使 谱 图 在 时 间 轴 上 的 变化 更 平滑 ， 我 们 设置 连续 两 块 数据 的 偏 移 量 为 住 size/16 个 
取样 点 。 也 就 是 说 两 块 数据 之 间 有 15/16 的 部 分 是 重复 的 。@ 计 算 能 将 频率 扫描 波 sweep 分 成 
的 块 数 。@ 使 用 as_strided0 将 sweep 的 形状 改 为 qumber, 住 size)， 并 且 设 置 strides 的 值 。 得 到 
的 结果 data 是 一 个 二 维 数组 ， 它 的 每 一 行 对 应 原始 信号 的 一 个 分 块 。 

@ 使 用 Hann 窗 对 分 块 信号 进行 平滑 处 理 ， 减 少 频谱 泄漏 。 注 意 由 于 data 中 的 每 行 之 间 有 
共用 的 数据 ， 因 此 不 能 使 用 下 面 自 更 新 的 乘法 : 


data *= window 


人 @ 调 用 rffi0 对 信号 进行 FFT 计算 ,由 于 axis 参数 为 1, rffi0 会 对 data 中 的 每 一 行 数据 进行 


FFT 运算 。@ 最 后 调用 imshow0 绘 制图 像 ， 并 调用 colorbar0 显 示 出 颜色 和 值 之 间 的 关系 。 
实际 上 , pylab 模块 中 已 经 提供 了 绘制 谱 图 的 函数 specgram0， 对 于 上 面 的 频率 扫描 波 ， 可 
以 使 用 下 面 的 语句 绘制 相同 的 谱 图 。 其 中 ， 第 一 个 参数 是 表示 信号 的 数组 ， 第 二 个 参数 是 FFT 
的 长 度 ， 第 三 个 参数 是 信号 的 取样 频率 ，noverlap 参数 是 连续 两 块 数据 之 间 重生 部 分 的 长 度 。 
specgram0 还 有 许多 其 他 的 关键 字 参 数 ， 请 读者 阅读 函数 文档 以 了 解 它 的 详细 用 法 。 


>>> import pylab as pl 
>>> pl.specgram(sweep, fft_size, sampling rate, noverlap = 1624-step) 


下 面 是 一 个 用 PyAudio、TraitsUI 及 Chaco 等 制作 的 观察 谱 图 的 程序 。 它 实时 地 从 声卡 读 
入 声音 数据 ， 并 绘制 出 声音 信号 的 时 间 波 形 、 频 谱 及 谱 图 。 由 于 本 程序 对 计算 机 的 配置 要 求 较 
高 ， 请 读者 在 较 快 的 机 器 上 运行 本 程序 。 另 外 ， 为 了 计算 效率 ， 程 序 中 没有 使 用 窗 函 数 和 重大 
处 理 。 图 15-14 是 程序 的 界面 截图 。 


a spectrogram realtime.py 
实时 观察 声音 信号 的 谱 图 


: 
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15-14 使 用 TraitsUI 和 Chaco 制作 的 实时 观察 声音 信号 谱 图 的 界面 


使 用 STFT 计算 的 谱 图 存在 一 个 问题 : 它 在 时 间 轴 和 频率 轴 上 的 分 辩 率 都 是 均一 的 ， 即 谱 
图 中 的 任意 两 块 大 小 相同 的 区 域 所 对 应 的 时 间 范 围 和 频率 范围 都 完全 相同 。 

然而 ， 由 于 高 频 信号 的 变化 速度 很 快 ， 为 了 观察 高 频 信号 的 变化 ， 我 们 希望 高 频 信号 在 时 
间 轴 上 的 分 辨 率 高 一 些 , 也 就 是 用 更 短 的 FFT 计算 频谱 。 而 人 类 的 听觉 对 于 低频 信号 的 频率 变 
化 更 为 敏感 , 因此 对 于 低频 信号 我 们 希望 在 频率 轴 上 的 分 辨 率 高 一 些 , 也 就 是 用 更 长 的 FFT 计 
算 频 率 。 

小 波 变换 能 够 解决 这 个 矛盾 ， 在 小 波 变 换 的 谱 图 上 ， 低 频 部 分 的 频率 分 辩 率 高 而 时 间 分 辨 
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率 低 ， 高 频 部 分 的 时 间 分 辩 率 高 而 频率 分 辩 率 低 。 感 兴趣 的 读者 可 以 阅读 下 面 的 教程 : 


http://users.rowan.edu/~polikar WAVELETS/WTtutorial html 
关于 小 波 变 换 和 STFT 的 教程 


为 


15.3 卷 积 运算 


我 们 知道 , 信号 x 经 过 系统 h 之 后 的 输出 是 x 和 h 的 卷 积 , 虽然 卷 积 的 计算 方法 很 简单 ， 
但 是 当 x 和 都 很 长 的 时 候 ， 卷 积 计 算是 非常 耗费 时 间 的 。 因 此 对 于 响应 时 间 很 长 的 系统 h， 
需要 找到 比 直接 计算 卷 积 更 快 的 方法 。 

信号 系统 理论 中 有 这 样 一 个 规律 : 时 域 的 卷 积 等 于 频 域 的 乘积 ， 因 此 要 计算 时 域 的 卷 积 ， 
可 以 将 时 域 信 号 转换 为 频 域 信号 , 进行 乘积 运算 之 后 再 将 结果 转换 为 时 域 信号 , 实现 快速 卷 积 。 


15.3.1 快速 卷 积 


由 于 FFT 运算 可 以 高 效 地 将 时 域 信 号 转换 为 频 域 信号 ， 其 运算 的 复杂 度 为 O(N .log N)， 
因此 三 次 FFT 运算 加 一 次 乘积 运算 的 总 复杂 度 仍 然 为 O(N . log) 级 别 ， 而 卷 积 运算 的 复杂 度 
为 O(N?)， 显 然 通过 FFT 计算 卷 积 要 比 直接 计算 快 得 多 (这 里 假设 需要 卷 积 的 两 个 信号 的 长 度 
都 为 N)。 

但 是 有 一 个 问题 : FFT 运算 假设 计算 的 信号 为 周期 信号 ， 因 此 通过 上 述 方法 计算 出 的 结果 
实际 上 是 两 个 信号 的 循环 卷 积 ， 而 不 是 线性 卷 积 。 为 了 用 FFT 计算 线性 卷 积 ， 需 要 对 信号 进行 
补 零 扩展 ， 使 得 其 长 度 大 于 线性 卷 积 结果 的 长 度 。 

例如 ， 如 果 要 计算 数组 a 和 ob 的 卷 积 ，a 和 ob 的 长 度 都 为 128， 那 么 它们 的 卷 积 结果 的 长 
度 为 len(a) +len(b) 一 1=255。 为 了 让 FFT 能 够 计算 线性 卷 积 , 需要 将 a 和 b 的 长 度 都 扩展 到 256。 
下 面 的 程序 演示 了 这 个 计算 过 程 : 


a spectrum 俯 _convolve.py 
使 用 FFT 进行 快速 卷 积 运算 


import numpy as np 


def fft_convolve(a,b): 
n = len(a)+len(b)-1 
N = 2**(int(np.log2(n))+1) © 
A = np.fft.fft(a，N) © 
B = np.fft.fft(b, N) 
return np.fft.ifft(A*B)[:n] © 


if _name_ ”== main 
a=np.random.rand(128) 
b = np.random.rand(128) 
c= np.convolve(a,b) 
print np.sum(np.abs(c - fft_convolve(a,b))) 


程序 输出 直接 卷 积 和 FFT 快速 卷 积 的 结果 之 间 的 误差 ， 大 约 为 Se 一 12 左右 。 

在 这 段 程序 中 ，a、b 的 长 度 为 128， 卷 积 结果 c 的 长 度 为 n=255。@ 找 到 大 于 n 的 最 小 的 
2 的 整数 次 暴 。@ 信 0 的 第 二 个 参数 为 FFT 的 长 度 ， 当 输入 数据 的 长 度 不 够 时 ，fhO 自 动 对 其 进 
行 补 零 。@ 最 后 对 两 个 频 域 信号 的 乘积 调用 ifhi0， 得 到 时 域 信号 的 卷 积 。 结 果 比 实际 的 卷 积 结 
果 多 一 个 数 ， 这 个 多 出 来 的 数值 应 该 接近 于 0， 请 读者 自行 验证 。 

由 于 直接 计算 卷 积 和 使 用 FFT 的 快速 卷 积 的 复杂 度 级 别 不 同 , 因此 当 卷 积 数据 很 长 时 , 可 
以 观察 到 明显 的 速度 差别 。 下 面 的 程序 比较 两 种 卷 积 算法 的 运算 时 间 : 


>>> import timeit 

>>> setup="""import numpy as np 
a=np.random.rand(16666) 

b=np.random.rand(16666) 

from spectrum_fft_convolve import fft_convolve”"” 

>>> timeit.timeit("np.convolve(a,b)",setup，number=16) 
1.852968578146891 

>>> timeit.timeit("fft_convolve(a,b)",setup，number=16) 
8.19475575866416145 


显然 ,计算 两 个 很 长 的 数组 的 卷 积 ，FFT 快速 卷 积 要 比 直接 卷 积 快 很 多 。 但 是 对 于 较 短 的 
数组 ， 直 接 卷 积 运算 将 更 快 一 些 。 图 15-15 显示 了 直接 卷 积 和 快速 卷 积 的 平均 计算 时 间 和 长 度 
之 间 的 关系 ( 见 文 前 彩 插 )。 其 中 ，Y 轴 显 示 的 是 每 个 数据 的 平均 计算 时 间 。 


a Spectrum fR convolve_timeitpy 
比较 直接 卷 积 和 快速 卷 积 的 计算 时 间 


9,907 FFT 类 积 


1646 2 E E Sees 869 ?006 
# 间 


图 15-15 ”FFT 快速 卷 积 和 直接 卷 积 的 时 间 复 杂 度 比较 
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由 于 图 15-15 中 立轴 显示 的 是 每 个 数据 的 计算 时 间 , 因此 对 于 直接 卷 积 它 是 线性 的 : O(N?)/N 。 
我 们 看 到 对 于 长 度 大 于 1024 的 计算 ， 快 速 卷 积 显示 出 明显 的 优势 。 

由 于 FFT 卷 积 很 常用 ， 因 此 scipy.signal 库 中 提供 了 ffconvolve0， 此 函数 采用 FFT 运算 ， 
并 可 计算 多 维 数 组 的 卷 积 。 


15.3.2 ”分 段 运算 


现在 考虑 对 于 输入 信号 x 和 系统 响应 的 卷 积 运算 。 通 常 输入 信号 是 非常 长 的 ， 例 如 要 对 
某 段 录 音 进 行 滤波 处 理 , 假设 取样 频率 为 8k Hz, 录音 长 度 为 1 分 钟 ， 则 数据 的 长 度 为 480000。 
而 如 果 需 要 对 麦克 风 的 输入 信号 进行 连续 的 滤波 处 理 ， 那 么 输入 信号 的 长 度 可 以 看 做 无 限 长 。 
系统 响应 的 长 度 通常 都 是 固定 的 ， 例 如 它 可 能 是 某 个 房间 的 脉冲 响应 ， 或 者 是 某 种 FIR 滤波 
器 的 系数 。 

根据 前 面 的 介绍 , 为 了 有 效 地 利用 FFT 计算 卷 积 , 我 们 希望 它 的 两 个 输入 长 度 相当 ,于 是 
就 需要 对 输入 信号 进行 分 段 处 理 。 卷 积 的 分 段 运算 被 称 为 overlap-add 运算 。 

overlap-add 运算 的 计算 方法 如 图 15-16 所 示 。 


Spectrum overlap_add plot.py 
到 一 。 绘制 overlap-add 运算 演示 图 


分 机 六 积 演示 


, 


| 


| 


15-16 ”使 用 overlap-add 进行 分 段 卷 积 的 过 程 演示 


图 中 原始 信号 x 的 长 度 为 300， 将 它 分 为 三 段 ， 分 别 与 滤波 器 系数 h 进行 卷 积 计算 ，h 的 
长 度 为 101， 因 此 每 段 输 出 200 个 数据 ， 图 中 用 绿色 标 出 每 段 输出 的 200 个 数据 。 这 3 段 数据 
按照 时 间 顺 序 进行 求 和 之 后 ， 得 到 的 结果 和 原始 信号 的 卷 积 是 相同 的 。 

因此 将 持续 的 输入 信号 x 和 滤波 器 h 进行 卷 积 的 运算 可 以 按照 如 下 步骤 进行 , 假设 h 的 长 
度 为 M: 

(1) 建立 一 个 缓存 ， 大 小 为 N+M 一 1， 初 始 值 为 0。 

(2) 每 次 从 x 中 读 取 N 个 数据 ， 和 bh 进行 卷 积 ， 得 到 N + M1 个 数据 。 将 这 些 数 与 缓存 
中 的 数据 进行 求 和 ， 并 将 结果 保存 到 缓存 中 ， 最 后 输出 缓存 的 前 N 个 数据 。 

G) 将 缓存 中 的 数据 向 左 移动 N 个 元 素 ， 也 就 是 让 缓存 中 的 第 N 个 元 素 成 为 第 0 个 元 素 ， 
左 移 完成 之 后 将 缓存 中 后 面 的 N 个 元 素 全 部 设置 为 0。 

(4) 跳 转 到 步骤 (2) 重 复 进 行 。 

下 面 是 实现 这 一 算法 的 演示 程序 : 


sl spectrum overlap_add.py 
分 段 卷 积 演示 


import numpy as np 

x = np.random.rand(1666) 
h = np.random.rand(161) 
y = np.convolve(x, h) 


N = 56 # 分 段 大 小 
M = len(h) # 滤波 器 长 度 


output = [] 


# 组 存 初始 化 为 8 
buffer = np.zeros(M+N-1,dtype=np.float64) 


for i in xrange(len(x)/N): 
# 从 输入 信号 中 读 取 N 个 数据 
xslice = x[i*N:(i+1)*N] 
# 计 算 卷 积 
yslice = np.convolve(xslice，h) 
# 将 卷 积 的 结果 加 入 到 缓存 中 
buffer += yslice 
# 输 出 缓存 中 的 前 N 个 数据 ， 注 意 使 用 copy， 否 则 输出 的 是 buffer 的 一 个 视图 
output.append( buffer[:N] .copy() ) © 
# 缓 存 中 的 数据 左 移 N 个 元 素 
buffer[@:-N] = buffer[N:] 
# 后 面 的 补 @ 
buffer[-N:] = 6 
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# 将 输出 的 数据 组 合 为 数组 

y2 = np.hstack(output) 

# 计 算 和 直接 卷 积 的 结果 之 间 的 误差 

print "error:", np.sum(np.abs( y2 - y[:len(x)] ) ) 


@ 注 意 需要 输出 缓存 中 前 N 个 数据 的 副本 , 否则 输出 的 是 数组 的 一 个 视图 , 当 此 后 缓存 buffer 
更 新 时 ， 视 图 中 的 数据 会 一 起 更 新 。 程 序 输出 直接 卷 积 和 overlap-add 分 段 卷 积 的 误差 : 


error: 2.11468668349e-12 


将 FFT 快速 卷 积 和 overlap-add 相 结合 ， 可 以 制作 出 一 些 快 速 的 实时 数据 滤波 算法 。 但 是 
由 于 FFT 卷 积 对 于 两 个 长 度 相当 的 数组 最 为 有 效 ， 因 此 在 分 段 时 也 会 有 所 限制 。 例 如 ， 如 果 滤 
波 器 的 长 度 为 2048， 那 么 理想 的 分 段 长 度 也 为 2048; 如 果 将 分 段 长 度 设置 得 过 低 ， 反 而 会 增 
加 运算 量 。 因 此 在 实时 性 要 求 很 强 的 系统 中 ， 只 能 采用 直接 卷 积 。 


15.4 信号 处 理 


有 些 信号 处 理 算法 很 难 对 时 域 信号 直接 处 理 ， 而 在 频 域 进行 计算 则 会 很 简单 。 频 域 信号 处 
理 的 大 致 步 又 如 图 15-17 所 示 。 


15-17 ” 频 域 信号 处 理 示 意图 


(1) 首先 将 输入 信号 以 每 N 个 取样 为 一 组 进行 分 块 ，N 为 2 的 整数 次 寡 。 
(2) 以 12 的 重 释 率 对 2*N 个 取样 信号 进行 FFT 计算 。 

(3) 对 FFT 的 计算 结果 进行 频 域 信号 处 理 。 

(4) 用 IFFT 将 处 理 后 的 频 域 信号 转换 为 时 域 信号 。 


(5) 每 块 时 域 信号 都 与 2*N 点 的 Hann 窗 进行 乘积 运算 。 
(0) 将 得 到 的 时 域 信号 以 1/2 的 重 又 率 进行 到 加 ， 得 到 处 理 后 的 时 域 信号 。 
这 种 处 理 算法 直接 对 信号 的 频谱 进行 修改 ， 然 后 再 通过 IFFT 转换 为 时 域 信号 。 


于 是 分 


块 计算 ,转换 后 的 信号 之 间 没 有 很 好 的 连续 性 ， 因 此 需要 用 1/2 重 登 率 和 Hann 窗 在 两 个 信号 


块 之 间 进行 平滑 过 度 。 
15.4.1 基本 框架 


从 算法 流程 可 以 看 出 ， 除 了 频 域 信 号 处 理 部 分 会 根据 应 用 的 不 同 而 改变 之 外 ， 其 余部 分 的 
运算 都 是 不 变 的 。 因 此 可 以 编写 如 下 用 于 频 域 处 理 的 基 类 程序 ， 实 现 处 理 中 通用 部 分 的 计算 ， 


然后 由 其 派生 类 实现 不 同 的 频 域 信号 处 理 算法 。 


g # spectrum freq process.py 
窟 也 ” 频 域 信 号 处 理 的 基 类 程序 


import numpy as np 
import wave 


class FrequencyProcess(object): 
def _init (self, infile, outfile, fft_size): © 
self.fft_size = fft_size 


if type(infile) == str: 
f = wave.open(infile, "rb") 
nchannels, sampwidth, framerate, nframes, _, _ = f.getparams() 
if nchannels != 1: 
print "only support one channel wave file” 
self.framerate = framerate 


self.input = np.fromstring(f.readframes(nframes), dtype=np.short) 


f.close() 

else: 
self.input = infile 
self.framerate = 44166 


self.result = self.process() 


f = wave.open(outfile, "wb") 

f.setnchannels(1) 

f.setsampwidth(2) 

f.setframerate(self.framerate) 
f.writeframes(self.result.astype(np.short).tostring()) 
f.close() 
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def process init(self): 
" 频 域 信号 处 理 的 初始 化 " 


pass 


def process block(self, block): 
"对 频 域 信号 块 block 进行 处 理 ， 并 返回 " 
return block 
def process(self) : 
self.process_init() © 
out = np.zeros(len(self.input)) 
window = np.hanning(self.fft size) 
start = 9 
while start + self.fft_size < len(self.input): 
block time = self.input[start:start+self.fft_size] 
block freq = np.fft.rfft(block_ time) 
block freq = self.process block(block freq) ®© 
block time = np.fft.irfft(block_freq) 
out[start:start+self.fft_size] += block time * window # hanning 窗 
start += self.fft_size//2 


return out 


@ 在 对 象 初始 化 方法 ”init 0 中 ， 首 先 从 输入 WAVE 文件 中 读 入 声音 数据 ， 然 后 调用 
process0 对 输入 数据 进行 频 域 信号 处 理 ,最 后 将 处 理 之 后 的 数据 写 到 输出 WAVE 文件 中 。 为 了 
方便 演示 后 面 将 要 介绍 的 各 种 频 域 处 理 算法 ， 如 果 参 数 infile 不 是 字符 串 ， 就 直接 把 它 当做 数 
组 使 用 ， 此 时 的 取样 频率 固定 为 44.1k Hz。 

在 process0 中 ,@ 首 先 调用 process_init0 进 行 频 域 处 理 算法 的 初始 化 , 基 类 中 的 process_init0 
不 做 任何 事情 , 需要 用 其 派生 类 覆盖 此 方法 。 然 后 以 1/2 重 又 率 , 对 输入 数据 进行 FFT 和 IFFT 
运算 。@ 对 于 计算 得 到 的 每 个 频 域 数据 块 block_freq， 都 调用 process_block0 对 其 进行 处 理 ， 
process_block0 也 需要 用 派生 类 覆盖 。 


15.4.2 ” 频 域 滤波 器 


对 频 域 信号 中 的 每 个 频率 分 量 都 乘 以 不 同 的 系数 ， 就 能 形成 一 个 频 域 信号 滤波 器 。 它 和 时 
域 滤波 器 相 比 ， 具 有 易于 设计 及 计算 速度 快 等 特点 。 下 面 是 频 域 滤波 器 的 程序 代码 : 


办 spectrum freq filterpy 
。 频 域 滤波 器 


遂 


import numpy as np 
from scipy.interpolate import UnivariateSpline 


from spectrum_freq_process import FrequencyProcess 


class FrequencyFilter(FrequencyProcess) : 
def _init_ (self，infile，outfile，fft_size，parameters): © 
self.parameters = parameters 
super(FrequencyFilter, self)._ init (infile, outfile, fft_size) 


def process init(self): 
self.freqs = np.arange(@, self.fft_ size//2+1, 1.8) 
freq_points = [] 
freq_gains = [] 
for freq, gain in self.parameters: 
# 实际 频率 转换 为 frequency bin 
freq_points.append(float(freq) / self.framerate * self.fft_size) 
freq_gains.append( 16**(gain/26.6) ) # dB 转换 为 乘积 系数 
gain_func = UnivariateSpline(freq_points，freq_gains，k=1，s=6) © 
self.gain = gain_func(self.freqs) 


def process block(self, block): 
return block * self.gain © 


if _name_ == "_ main “: 
from scipy import signal 
t = np.arange(86，16，1/44166.6) 
sweep = signal.chirp(t，f6=166，tl1 = 196，f1=4666) + 16668 
FrequencyFilter(sweep, "chrip filter.wav", 1024, 

[(98,8), (260, 0),(4060, -20), (10060, -20), 

(1560, 8),(3600, 9),(3560, -20),(36000, -20)]) 
FrequencyFilter("voice.wav", "voice filter.wav", 1024, filter settings) 


@ 初 始 化 方法 _init _0 中 的 parameters 参数 是 一 组 (频率 [Hz], 增 益 [dB]) 的 列表 。@ 用 一 阶 
UnivariateSpline 对 象 对 parameters 参数 进行 线性 插值 ， 得 出 每 个 频率 窗口 对 应 的 增益 系数 。 由 
于 在 滤波 计算 时 ， 系 数 是 固定 不 变 的 ， 因 此 系数 的 计算 在 process init0 中 进行 。 四 而 
process_block0 则 只 是 简单 地 返回 频率 信号 与 其 对 应 的 系数 的 乘积 。 

为 了 测试 程序 的 效果 ， 我 们 对 频率 扫描 波 数据 进行 比较 复杂 的 滤波 。 图 15-18 是 程序 输出 
的 WAVE 文件 的 波形 。 


15-18 ” 频 域 滤波 器 对 频率 扫描 波 的 滤波 结果 
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于 我 们 先 将 以 dB 为 比例 度量 的 增益 参数 转换 为 乘积 系数 ， 再 对 其 进行 线性 插值 ， 因 此 
波形 的 振幅 都 是 线性 变化 的 。 读 者 可 以 修改 程序 ， 先 对 增益 参数 进行 线性 插值 ， 再 转换 为 乘积 
系数 ， 看 看 波形 振幅 有 何 变化 。 


15.4.3 ”频率 变调 处 理 


对 频 域 信号 进行 压缩 或 拉 伸 ， 将 改变 对 应 的 声音 信号 的 音调 ， 即 可 以 把 男声 变 为 女声 或 者 
把 女声 变 为 男声 。 下 面 是 声音 变调 程序 : 


A spectrum freq_scale py 
-声音 变调 


import numpy as np 
from spectrum_freq_process import FrequencyProcess 
from scipy.interpolate import UnivariateSpline 


class FrequencyScale(FrequencyProcess): 
def _init_(self，infile，outfile，fft_size，scale) : 
Self.scale = Scale 
super(FrequencyScale, self)._init (infile, outfile, fft_size) 


def process init(self): 
self.freqs = np.arange(8, self.fft_ size//2+1, 1.0) 


def process_block(self, block): 
new freqs = self.freqs * self.scale 
freqs_re = UnivariateSpline(new freqs, np.real(block), k=3, s=0) © 
freqs_im = UnivariateSpline(new_freqs, np.imag(block), k=3, s=0) 
block = freqs_re(self.freqs) + 1j*freqs_im(self.freqs) @ 
block[int(np.max(new freqs)):] = 6 © 
return block 


if _name_ == "_ main_": 


FrequencyScale("voice.wav", "voice fscale.wav", 1024, 6.8) 


@ 使 用 两 个 UnivariateSpline 对 象 分 别 对 频 域 信号 block 的 实数 部 分 和 虚数 部 分 进行 插值 。 
@ 注 意 这 里 使 用 的 是 变调 之 后 的 频率 窗口 作为 X 轴 的 数据 , 然后 再 使 用 原来 的 频率 窗口 对 两 个 
样 条 曲线 进行 求 值 ， 计 算 变 调 之 后 每 个 频率 窗口 对 应 的 值 。 

例如 ， 当 scale 为 2.0 时 ， 原 来 的 100 Hz 的 频率 成 分 ， 就 变 成 了 200 Hz 的 频率 成 分 ， 相 当 
于 沿 着 频率 轴 拉 伸 了 频率 信号 。 自 当 scale<1.0 时 ， 相 当 于 对 频率 信号 进行 压缩 处 理 ， 因 此 高 频 
部 分 会 超出 样 条 曲线 的 取 值 范围 , 变 成 外 推 计算 , 因此 需要 将 这 部 分 外 推 计算 的 结果 修改 为 0。 

此 程序 处 理 之 后 的 声音 效果 并 不 是 很 好 , 更 完美 的 变调 算法 需要 计算 声音 波形 的 自 相似 情 
况 ， 找 到 合适 的 波形 分 割 点 进行 分 块 处 理 。 


15.4.4 用 谱 图 差 减 法 降 噪 


在 使 用 麦克 风 录制 声音 信号 时 ， 由 于 受 设备 的 电气 噪声 或 环境 噪声 的 影响 ， 录 制 的 声音 信 
号 通常 会 带 有 一 定 的 背景 噪声 ， 例 如 常见 的 “ 沙 一 沙 一 ” 声 。 通常 这 种 背景 噪声 都 具有 不 变性 ， 
即 它 的 频谱 特性 不 会 随 着 时 间 的 变化 而 改变 。 这 时 可 以 使 用 谱 图 差 减 法 去 除 背 景 噪声 ， 具 体 算 
法 如 下 : 

(1) 录制 一 段 纯 背景 噪声 。 

(2) 对 背景 噪声 计算 频谱 能 量 的 平均 值 。 

(3) 对 声音 信号 进行 分 段 FFT， 对 于 每 个 频率 f 都 按照 如 下 公式 计算 其 增益 系数 ， 其 中 PP， 
和 ,分 别 为 声音 信号 和 噪声 的 能 量 。 


gain(f)=min[(P,(f) -aP, (f))/P,(7),P)] 


(4) 使 用 gainW 对 输入 信号 的 频谱 进行 乘积 计算 ， 得 到 输出 信号 的 频谱 。 
下 面 是 实现 此 算法 的 程序 : 


s spectrum spectral_subtract.py 
全 二 使 用 谱 图 差 减 法 去 除 背 景 噪声 


import numpy as np 
from spectrum_freq_process import FrequencyProcess 


def average_spectrum(data, fft_size): 
"以 1/2 的 覆盖 率 计算 data 信号 的 每 个 频率 的 平均 能 量 " 
p = np.zeros(fft_size//2+1) 
start = 9 
n=08 
while start + fft_size < len(data): 
tmp = np.abs(np.fft.rfft(data[start:start+fft_size])) 
p += tmp*tmp 
n += 1 
start+=fft_size//2 
p/=n 
returnp 


class SpectrumSubtract(FrequencyProcess): 
def _init_(self, infile, outfile, fft_size, noise_len, a, b): 
self.noise_len = noise_len 
self.a=a 
self.b=b 
super(SpectrumSubtract, self)._ init (infile, outfile, fft_ size) 
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def process init(self): 
self.noise = average_spectrum(self.input[:self.noise len], self.fft_ size) 
self.avg_gain = np.zeros(self.fft_size//2+1) 
# 频率 平滑 用 的 卷 积 窗口 
self.moving window = np.hanning(9) 
self.moving window /= np.sum(self.moving_window) 
self.moving size = len(self.moving window)//2 


def process block(self, block): 
block_power = np.abs(block) ** 2 # 信 号 block 的 能 量 


# 由 谱 相 减 得 到 的 每 个 频率 窗口 的 gain 
gain = (block power - self.a*self.noise)/block_power 
np.clip(gain, self.b, 1e20, gain) 


# 对 gain 在 频率 上 进行 平滑 处 理 
gain = np.convolve(gain，self.moving_window) 
gain = gain[self.moving_size:self.moving_size+self.fft_size//2+1] 


# 对 gain 在 时 间 上 进行 平滑 处 理 
self.avg_gain *= 0.8 

gain *= 8.2 

self.avg_gain += gain 

# 处 理 块 

block *= self.avg_ gain 
return block 


if _name_ == "_main_": 


SpectrumSubtract("voice.wav", "voice ss.wav", 20648, 138860660, 1.2, 8.05) 


程序 中 假设 输入 的 声音 信号 的 最 前 面 是 一 段 无 信号 的 背景 噪声 ， 通 过 noise len 参数 指定 
这 段 背 景 噪声 的 长 度 。 除 了 实现 上 述 算法 之 外 ， 程 序 还 对 每 个 块 计算 所 得 的 sai 进行 频率 之 
间 的 平滑 处 理 ， 以 及 时 间 上 (前 后 块 之 间 ) 的 平滑 处 理 。 这 样 能 够 防止 声音 信号 产生 过 度 的 变化 
降低 谱 图 差 减法 带 来 的 音乐 噪声 (musical noise)。 两 种 平滑 处 理 的 参数 都 是 固定 的 : 频率 平滑 窗 
口 为 HH 点 Hann 窗 ， 而 时 间 平 滑 参数 为 0.8。 读 者 可 以 将 其 修改 为 传 入 的 参数 ， 测 试 它们 对 输 
出 声音 的 影响 。 


15.5 ”Hilbert 变换 


Hilbert 变换 能 在 振幅 保持 不 变 的 情况 下 将 输入 信号 的 相 角 偏 移 90”, 简单 地 说 就 是 能 将 正 
弦 波 转换 为 余弦 波 ， 下 面 的 程序 可 验证 这 一 特性 : 


到 spectrum hilbert_sin.py 
二 正弦 波 的 Hilbert 变换 


from scipy import fftpack 
import numpy as np 
import matplotlib.pyplot as pl 


# 产生 1624 点 4 个 周期 的 正弦 波 
= np.linspace(0, 8*np.pi, 1824, endpoint=False) 
x = np.sin(t) 


# 进行 Hilbert 变换 

y = fftpack.hilbert(x) 
pl.plot(x，1label=u" 原 始 波形 ") 
pl.plot(y，1label=u"Hilbert 转换 后 的 波形 ") 
pl.legend() 

pl.show() 


程序 的 输出 如 图 15-19 所 示 ，hilbert0 将 正弦 波 变换 成 了 余弦 波 ( 见 文 前 彩 插 )。 


图 15-19 Hilbert 变换 将 正弦 波 变换 为 余弦 波 


Hilbert 正 变换 的 相 角 偏 移 符 号 
本 书 将 相 角 偏 移 +90” 称 为 Hilbert 正 变换 。 有 的 文献 或 书籍 则 正好 将 定义 倒转 过 来 : 将 
偏 移 +90” 称 为 Hilbert 负 变换 ， 而 将 偏 移 -90” 称 为 Hilbert 正 变换 。 


相 角 偏 移 90” 相 当 于 复数 平面 上 的 点 与 虚数 单位 1j 相 乘 ， 因 此 Hilbert 变换 的 频率 响应 可 
以 用 如 下 公式 给 出 : 


H(@)= jsgn(@) 
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其 中 ，ow 为 圆 频率 ，sgn 函数 为 符号 函数 ， 即 : 


| @>0 
sgn(@) = | 0, @=0 
一 L O<0 
我 们 可 以 将 其 频率 响应 理解 为 : 
。 直流 分 量 为 0 


。 正 频 率 成 分 偏 移 +190” 

。 负 频 率 成 分 偏 移 -90* 

对 于 实数 信号 来 说 ， 正 负 频 率 成 分 共 匈 ， 因 此 对 实数 信号 进行 Hilbert 变换 之 后 仍然 是 实 
数 信号 。 下 面 的 程序 验证 Hilbert 变换 的 频率 响应 : 


5 # spectrum _ hilbert_freq.py 
半球 使 用 FFT 验 证 Hilbert 变换 的 频率 响应 


>>> x = np.random.rand(16) 

>>> y = fftpack.hilbert(x) 

>>> X = np.fft.fft(x) 

>>> Y = np.fft.fft(y) 

>>> np.imag(Y/X) 
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对 信号 进行 N 点 FFT 变换 之 后 : 

。 下 标 为 0 的 频率 分 量 表示 直流 分 量 

e 下 标 为 N/2 的 频率 分 量 为 取样 频率 /2 的 频率 分 量 

e 1 到 N/2 一 1 为 正 频率 分 量 

e N/2+1 到 NN 为 负 频 率 分 量 

对 照 Y/X 的 虚数 部 分 ， 不 难看 出 它 符合 Hilbert 频率 响应 。 如 果 用 np.real(Y/X) 观 察 实数 部 
分 ， 可 以 看 到 它们 全 部 接近 于 0。 

Hilbert 变换 可 以 用 作 包 络 检 波 ， 具 体 算法 如 下 所 示 : 


envelope = 小 百 ( +x’ 


其 中 , x 为 原始 载波 波形 , H(x) 为 x 经 Hilbert 变换 之 后 的 波形 ，envelope 为 信号 x 的 包 络 。 
其 原理 很 容易 理解 : 假设 x 为 正弦 波 ， 那 么 H(x) 为 余弦 波 ， 根 据 公 式 


sin’(1)+cos’(f) =1 


可 知 envelope 恒 等 于 1， 即 为 sin() 信 号 的 包 络 。 下 面 的 程序 验证 这 一 算法 , 程序 的 输出 如 
15-20 所 示 ( 见 文 前 彩 插 )。 


a spectrum hilbert_envelop.py 
”用 Hilbert 变换 进行 包 络 检 波 


import numpy as np 
import pylab as pl 
from scipy import fftpack 


t = np.arange(86，6.3，1/26666.9) 
x = np.sin(2*np.pi*1666*t) * (np.sin(2*np.pi*169*t) + np.sin(2*np.pi*7*t) + 3.0) 
hx = fftpack.hilbert(x) 


pl.plot(x，1label=u" 载 波 信号 ") 

pl.plot(np.sqrt(x**2 + hx*#*+2)，"r"，1linewidth=2，1abel=u" 检 出 的 包 络 信号 ") 
pl.legend() 

pl.show() 


图 15-20 使 用 Hilbert 变换 对 载波 信号 进行 包 络 检 波 


前 面 介绍 过 可 以 使 用 频率 扫描 波 测量 滤波 器 的 频率 响应 , 我 们 可 以 使 用 这 个 算法 计算 出 扫 
描 波 的 包 络 。 


a spectrum hilbert_sweep_envelop.py 
用 Hilbert 变换 计算 频率 扫描 波 的 包 络 


得 到 的 包 络 波形 如 图 15-21 所 示 ( 见 文 前 彩 插 )。 
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图 15-21 使 用 Hilbert 变换 对 频率 扫描 波 进行 包 络 检 波 


可 以 看 出 ， 在 高 频 和 低频 处 包 络 计算 出 现 较 大 的 误差 ， 而 在 中 频 部 分 则 能 很 好 地 计算 出 包 
络 的 形状 。 


虽然 Python 的 开发 效率 很 高 ， 但 是 它 的 执行 速度 却 很 难 满足 大 量 计算 的 应 用 需求 。 因 此 
我 们 使 用 NumPy、SciPy 等 库 ， 调 用 它们 已 经 封装 好 的 高 速 运算 程序 ， 尽 量 避免 直接 在 Python 
级 别 进行 大 量 的 循环 和 数值 计算 。 如 果 这 些 现成 的 库 无 法 完成 计算 要 求 ， 就 需要 用 更 高 效 的 语 
言 编 写 核心 的 计算 部 分 ， 并 为 之 提供 Python 的 调用 接口 ， 从 而 同时 实现 高 效 开发 和 高 效 运算 。 

本 章 介绍 几 种 在 Python 和 C/C++ 之 间 相互 调用 的 方法 。 为 了 阅读 本 章 的 内 容 ， 读 者 需要 
掌握 C/C++ 语言 的 一 些 相关 知识 。 


如 果 在 编译 本 章 的 实例 程序 时 出 现 错误 信息 ， 请 在 命令 行 中 输入 "where gcc" 查 看 
MinGW 编译 器 的 安装 路 径 。 如 果 路 径 中 存在 空格 或 中 文 ， 请 重新 安装 MinGW 编译 
器 到 全 英文 的 无 空格 路 径 之 下 。 路 径 中 的 空格 或 中 文 可 能 会 使 Python 无 法 正确 调用 
它 进行 编译 。 


16.1 用 ctypes 调用 DLL 库 


ctypes 是 Python 处 理 动 态 链接 库 的 标准 扩展 模块 ， 在 Windows 下 使 用 它 可 以 直接 调用 C 
语言 编写 的 DLL 动态 链接 库 。 由 于 它 对 传递 的 参数 不 进行 类 型 和 越界 检查 ， 因 此 如 果 编 写 的 代 
码 有 问题 ， 就 很 可 能 会 造成 程序 崩溃 。 将 数组 数据 使 用 指针 传递 时 ， 出 错 的 风险 将 更 大 。 

为 了 让 程序 更 加 安全 ， 通 常会 用 Python 代码 对 ctypes 调用 的 DLL 函数 进行 封装 ， 在 调用 
DLL 函数 之 前 ， 在 Python 级 别 对 数据 类 型 和 越界 进行 检查 。 这 样 做 会 使 调用 接口 部 分 比 调用 
其 他 的 一 些 手工 编写 的 扩展 模块 速度 慢 , 但 是 如 果 C 语言 函数 能 一 次 处 理 相当 多 的 数据 ， 那 么 
接口 调用 部 分 的 时 耗 是 可 以 忽略 不 计 的 。 

关于 ctypes 的 用 法 ,Python 的 说 明文 档 里 已 经 有 很 详细 的 说 明 。 下 面 我 们 着 重 介绍 如 何 通 
过 ctypes 让 C 语言 函数 能 处 理 NumPy 的 数组 。 

为 了 方便 动态 链接 库 的 载 入 ，NumPy 提供 了 一 个 便捷 函数 ctypeslib.load_library0。 它 有 两 
个 参数 ， 第 一 个 参数 是 库 的 文件 名 ， 第 二 个 参数 是 库 所 在 的 路 径 。 函 数 返 回 的 是 一 个 ctypes 的 
对 象 。 通 过 此 对 象 的 属性 可 以 访问 动态 链接 库 中 提供 的 函数 。 


se # ctypes\sum test.c, sum test.py 
污 ”用 SWIG 制作 扩展 模块 ,执行 “build_dll.bat” 就 可 以 用 MinGW 编译 sum test.c 
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例如 ， 如 果 有 一 个 名 为 “sum testdll” 的 动态 链接 库 ， 其 中 提供 一 个 函数 mysum0， 其 C 
语言 程序 如 下 : 


double mysum(double a[], long n) 
a 
double sum = 0; 
int i; 
for(i=@;i<n;i++) sum += a[i]; 
return sum; 


J 
可 以 使 用 如 下 语句 载 入 此 动态 链接 库 : 


>>> from ctypes import * 

>>> sum test = np.ctypeslib.load_library("sum test", ".") 
>>> print sum test.mysum 

<_Funcptr object at 89x637D7216> 


为 了 正确 调用 mysum0， 还 需要 对 其 参数 类 型 进行 说 明 ， 下 面 的 语句 描述 了 mysum0) 的 两 
个 参数 的 类 型 和 返回 值 的 类 型 ; 


>>> sum_test.mysum.argtypes = [POINTER(c_double)，c_long] 
>>> sum test.mysum.restype = c_double 


在 上 面 的 代码 中 ， 用 POINTER(c_double) 声 明 mysum0 的 第 一 个 参数 是 一 个 指向 双 精 度 浮 
点 数 的 指针 ， 用 c_long 表示 第 二 个 参数 的 类 型 是 长 整 型 。 返 回 值 的 类 型 由 restype 属性 指定 ， 
这 里 用 c_double 表示 返回 值 是 双 精度 浮 点 数 类 型 。 

然后 就 可 以 调用 mysum0 对 数组 进行 求 和 运算 了 : 


>>> x = np.arange(1，161，1.6) 
>>> sum test.mysum(x.ctypes.data_as(POINTER(¢_double)), len(x)) 
5656.6 


这 里 通过 x.ctypes.data_as(POINTER(c_double)), 将 数组 x 的 地 址 作为 (double *) 类 型 的 指针 
传递 给 mysum0。 

每 次 调用 mysum0 都 进行 类 型 转换 是 比较 麻烦 的 ， 因 此 可 以 编写 一 个 Python 函数 ， 将 
mysum0 封 装 起 来 : 


def mysum(x): 
return sum test.mysum(x.ctypes.data as(POINTER(c_double)), len(x)) 


由 于 数组 的 元 素 在 内 存 中 存储 时 可 以 是 不 连续 的 , 而 且 可 以 是 多 维 数组 ， 因 此 我 们 不 能 指 
望 前 面 的 mysum0 能 够 处 理 所 有 的 情况 ， 例 如 : 


>>> x = np.arange(1,11,1.6) 

>>> mysum(x[: :2] ) # 对 于 不 连续 的 数组 ， 结 果 是 错误 的 
15.6 

>>> sum(x[::2]) 

25.6 


于 x[::2] 和 x 共用 同一 块 内 存 空间 ， 而 x[::2] 中 的 元 素 是 不 连续 的 ， 每 两 个 元 素 之 间 的 间 
隔 为 16 个 字 节 (两 个 双 精度 浮 点 数 大 小 )。 因 此 若 将 它 传递 给 mysum0， 实 际 上 计算 的 是 数组 x 
中 前 5 项 的 和 : 1+2+3+4+5=15。 而 实际 上 我 们 希望 的 结果 是 : 1+3+5+7+9=25。 

为 了 对 数组 参数 进行 更 详细 的 描述 ，NumpPy 提供 了 ndpointer0。 它 有 4 个 参数 一 -dtype、 
ndim、shape 和 fags， 分 别 与 数组 的 4 个 同名 属性 对 应 。 用 ndpointer0 对 函数 的 参数 进行 描述 
之 后 ， 此 参数 只 能 接受 指定 类 型 的 数组 ， 并 且 能 自动 将 数组 转换 为 对 应 的 指针 参数 ， 例 如 : 


sum_test.mysum.argtypes = [ 
np.ctypeslib.ndpointer(dtype=np.float64, ndim=1, flags="C_ CONTIGUOUS"), 
c_long 


] 


上 面 的 代码 描述 了 mysum0 的 第 一 个 参数 是 一 个 类 型 为 双 精 度 浮 点 数 、 一 维 、C 语言 连续 
的 数组 。 在 调用 mysum0 时 ， 可 以 直接 传递 数组 ， 无 需 再 编写 一 个 Python 函数 对 其 进行 封装 ; 


>>> Sum_test.mysum(x, len(x)) 
55.6 


当 传 递 的 数组 不 满足 ndpointer0 的 指定 条 件 时 ， 就 会 报错 : 


>>> sum test.mysum(x[::2],1len(x)/2) 
ArgumentError: argument 1: <type ‘exceptions.TypeError'>: 
array must have flags ['C_CONTIGUOUS'] 


由 于 x[::2] 不 是 连续 的 ， 因 此 不 符合 flags="C_CONTIGUOUS" 的 设置 。 
如 果 我 们 希望 函数 能 够 处 理 多 维 、 不 连续 的 数组 ， 就 需要 把 数组 的 shape 和 strides 属性 都 
传递 给 它 。 下 面 的 mysum20 可 以 对 二 维 数组 的 所 有 元 素 进行 求 和 : 


double mysum2(double a[], int strides[], int shapes[]) 
double sum = @; 
int i1, j, M, N, S58, S1; 
M = shapes[8]; N=shapes[1]; 
S6 = strides[6] / sizeof(double); © 
S1 = strides[1] / sizeof(double); 


for(i=0;i<M;i++){ 
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for(j=8;j<N;j++){ 
sum += a[i*Se + j*S1]; © 
由 
让 


return sum; 


} 


mysum20 有 三 个 参数 ， 第 一 个 参数 a 是 数组 的 起 始 地 址 ，strides 参数 是 保存 数组 各 个 轴 元 
素 之 间 间 隔 的 数组 的 地 址 ，shapes 参数 是 保存 数组 各 个 轴 长 度 的 数组 的 地 址 。 我 们 只 对 二 维 数 
组 进行 处 理 ， 因 此 strides 和 shapes 数组 的 长 度 均 为 2。 
@ 由 于 strides 中 的 数值 以 字 节 为 单位 , 因此 需要 除 以 sizeofdouble) 计 算出 以 双 精 度 浮 点 数 
为 单位 的 间隔 长 度 S0 和 S1.@ 这 样 一 来 ,二 维 数组 a 中 的 第 i 行 ,第 j 列 的 元 素 便 可 以 通过 afi*S0 
+j*S]] 进 行 存 取 。 下 面 用 ctypes 对 mysum20 进 行 封装 : 


sum test.mysum2.restype = c_double 

sum_test.mysum2.argtypes = [ 
np.ctypeslib.ndpointer(dtype=np.float64, ndim=2), 
POINTER(c_int), 
POINTER(c_int) 

] 


def mysum2(x): 
return sum test.mysum2(x, x.ctypes.strides, x.ctypes.shape) 


在 Python 的 mysum20 中 ， 为 了 将 数组 x 的 strides 和 shape 属性 传递 给 C 语言 的 函数 ， 可 
以 使 用 x.ctypes 中 提供 的 strides 和 shape 属性 。 注 意 不 能 直接 传递 x.strides 和 x.shape， 因 为 这 
些 是 Python 的 元 组 对 象 ， 而 x.ctypes.shape 得 到 的 是 用 ctypes 封装 的 整数 数组 : 


>>> x = np.arange(1，161，1.6).reshape((26，5)) 

>>> x.ctypes.shape 

<numpy.core._internal.c_long_Array_2 object at 6x626B4DF6> 
>>> x.ctypes.shape[8], x.ctypes.shape[1] 

(20, 5) 


可 以 看 出 , x.ctypes.shape 是 一 个 C 语言 的 包含 有 两 个 元 素 的 长 整 型 数组 .下面 用 mysum20 
计算 二 维 数组 x 的 所 有 元 素 的 和 ， 此 外 还 验证 了 它 可 以 对 不 连续 的 数组 进行 运算 : 


>>> mysum2(x) 
5656.6 
>>> mysum2(x[: :2,::2]) == np.sum(x[: :2,::2]) # 可 以 对 不 连续 的 数组 进行 求 和 


True 


16.2 ”用 Weave 嵌入 C++ 程序 


在 3.8 节 曾 经 介绍 过 , 使 用 SciPy 库 的 Weave 模块 可 以 很 方便 地 将 C++ 程序 以 字符 串 的 形 
式 嵌入 到 Python 程序 中 。 本 节 详细 介绍 如 何 使 用 Weave 库 简 化 Python 中 的 C++ 程序 调用 ， 提 
高 程序 的 开发 和 运算 速度 。 


16.2.1 Weave 的 工作 原理 
Weave 能 自动 对 C++ 程序 进行 封装 ,添加 许多 编译 所 需 的 语句 ,并 将 生成 的 C++ 程序 保存 


到 某 个 位 置 ， 调 用 系统 中 的 C++ 编译 器 将 其 编译 为 pyd 文件 "。 使 用 下 面 的 语句 可 以 获得 封装 
之 后 的 源 程序 和 pyd 文件 的 路 径 : 


>>> from scipy import weave 
>>> weave.catalog.default_dir() 
'C:\\docume~1\\...\\locals~1\\temp\\...\\python26 compiled’ 


下 面 的 语句 可 以 获得 默认 使 用 的 C++ 编译 器 名 称 : 


>>> weave.platform_info.choose_compiler() 
msvC” 


下 面 的 语句 调用 C++ 的 printf0 输 出 变量 a 的 内 容 : 


>>> a = 169 
>>> weave.inline(r'printf("%d\n", a);', ["a"], compiler="gcc") 
166 


如 果 读 者 的 Windows 系统 中 安装 了 Visual C++ 编译 器 ， 那 么 Weave 默认 会 选择 它 作为 编 
译 器 。 但 使 用 msvc' 作 为 编译 器 会 遇 到 许多 麻烦 ， 因 此 建议 读者 采用 和 Python(x,y) 一 起 安装 的 
gcc 编译 器 (MinGW)， 只 需要 设置 compiler 参数 为 "gcc" 即 可 。 

由 于 第 一 次 运行 时 需要 调用 C++ 编译 器 进行 编译 ， 因 此 要 等 几 秒 钟 才能 看 到 运行 结果 。 下 
面 我 们 看 看 Weave 是 如 何 对 printf0 进 行 封装 的 。 打 开 weave.catalog.default dir0 目 录 中 最 新 创 
建 的 cpp 文件 。 此 文件 有 700 余 行 代码 ， 在 其 中 搜索 “printf” 就 可 以 找到 调用 printf0 的 代码 ， 
如 下 所 示 : 


static PyObject* compiled func(PyObject*self, PyObject* args) 
t 


PyObject *py_a; 


@ pyd 文 件 是 Python 的 动态 链接 库 模块 ， 在 Windows 下 它 和 DLL 文件 是 一 样 的 。 
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PyObject* raw locals _ attribute __ ((unused)); 
raw_locals = py to raw dict(py_locals," locals"); © 
PyObject* raw globals _ attribute __ ((unused)); 
raw_globals = py _ to raw dict(py_ globals,"_globals"); © 
/* argument conversion code */ 

py_a = get variable("a",raw locals,raw globals); ©@ 

int a = convert to int(py a,"a"); © 

/* inline code */ 

/* NDARRAY API VERSION 1666669 */ 

printf("%d\n", a); @ 


} 


我 们 只 需要 大 致 了 解 上 述 程序 的 结构 ， 没 有 必要 深究 每 条 语句 是 如 何 运行 的 。 

@ 首 先 通过 一 些 语句 得 到 两 个 PyObject 对 象 一 raw_locals 和 raw_globals， 它 们 相当 于 
Python 内 置 函数 locals0 和 globals0 的 返回 值 ， 是 两 个 Python 的 字典 对 象 ，Python 变量 a 的 值 
就 在 raw_globals 中 。 

@ 通 过 调用 get_ variable0 从 raw_locals 或 raw_globals 中 获得 变量 a 的 值 ， 获 得 的 是 一 个 
Python 的 整数 对 象 ， 因 此 用 py_a 指针 指向 它 。 

目 通 过 调用 convert to_int0 获 取 py_a 对 象 中 的 整数 值 , 并 赋值 给 一 个 C 语言 的 整 型 变量 a， 
这 样 就 完成 了 从 Python 变量 到 C 变量 的 转换 。 

@ 传 递 给 inline0 的 C 语言 代码 ， 将 调用 printf0 打 印 出 C 语言 变量 a 的 值 ， 也 就 是 Python 
变量 a 的 值 。 

从 上 面 的 程序 可 以 看 出 ,在 C 语言 程序 中 所 有 以 “py_” 开 头 的 变量 都 是 Python 对 象 ， 而 
和 Python 变量 同名 的 变量 则 是 调用 类 型 转换 函数 (convert_ to_int 等 ) 得 到 的 结果 。 在 调用 inline0 
时 ，Weave 会 根据 Python 变量 的 值 的 类 型 , 输出 不 同 的 代码 。 由 于 前 面 已 经 编译 过 a 为 整数 时 
的 程序 了 ， 因 此 再 次 执行 时 不 需要 重复 进行 编译 : 


>>> a = 200 
>>> weave.inline(r'printf("%d\n", a);', ["a"], compiler="gcc") 


如 果 将 a 改 为 浮 点 数 ， 那 么 Weave 就 需要 重新 编译 程序 了 : 


>>> a = 280.0 
>>> weave.inline(r'printf("%d\n", a);', ["a"], compiler="gcc") 
8 


由 于 printt0 中 使 用 “9%6d” 格 式 输出 数值 ， 因 此 无 法 正确 输出 浮 点 数 变量 a 的 值 。 编 译 输 
出 目录 下 会 增加 一 个 cpp 文件 ， 其 中 的 变量 类 型 转换 语句 变 成 了 : 


double a = convert to float(py_a,"a"); 


inline0 有 许多 关键 字 参 数 可 以 改变 它 所 输出 的 C 语言 程序 。 例 如 ， 通 过 headers 参数 可 以 
指定 程序 所 需 的 头 文件 列表 ， 通 过 support_code 参数 可 以 设置 主 程序 之 外 的 代码 ， 另 外 还 可 以 
定义 主 程序 中 使 用 的 函数 、 全 局 变量 、 结 构 体 以 及 类 等 代码 。 具 体 的 用 法 请 读者 参考 inline0 
的 使 用 手册 。 

Weave 安装 路 径 下 的 examples 文件 夹 中 有 许多 嵌入 C++ 程序 的 实例 ， 读 者 可 以 通过 运行 
这 些 例子 ， 并 查看 扩展 之 后 的 C++ 源 程序 ， 以 进一步 深入 了 解 Weave 的 工作 原理 。 


16.2.2 处理 NumPy 数组 


Weave 能 够 自动 在 Python 类 型 和 C++ 类 型 之 间 进 行 转换 。 要 编写 处 理 NumPy 数组 的 C++ 
程序 , 首先 要 弄 清楚 Weave 是 如 何 将 数组 传递 给 C++ 语言 的 。 下 面 的 语句 创建 一 个 元 素 类 型 为 
长 整 型 的 二 维 数组 a， 并 执行 weave.inline0 得 到 扩展 之 后 的 C++ 源 代码 : 


>>> import numpy as np 
>>> a = np.arange(12).reshape(-1,4) 
>>> weave.inline("//dummy",["a"], compiler="gcc") 


在 自动 扩展 之 后 的 C++ 程序 中 ， 进 行 类 型 转换 的 代码 如 下 : 


/* argument conversion code */ 

py_a = get_variable("a",raw_locals,raw_globals); 

PyArrayObject* a_array = convert_ to _numpy(py_a,"a"); 
conversion_numpy_check_type(a_array,PyArray_LONG, "a"); 

#define A1(i) (*((long*)(a_array->data + (i)*Sa[6]))) 

#define A2(i,j) (*((long*)(a_array->data + (i)*Sa[6] + (j)*Sa[1]))) 
#define A3(i,j,k) (*((long*)(a_array->data + (i)*Sa[6] + (j)*Sa[1] + (k)*Sa[2]))) 
#define A4(i,j,k,1) //... 太 长 ,省 略 

npy_intp* Na = a_array->dimensions; 

npy_intp* Sa = a_array->strides; 

int Da = a_array->nd; 

long* a = (long*) a_array->data; 


对 于 NumpPy 数组 a， 通 过 类 型 转换 程序 之 后 得 到 如 下 可 用 的 C++ 变量 : 

e py_a: PyObject 类 型 的 指针 。 

e@ a_array: PyArrayObject 类 型 的 指针 。 

e Na: 指向 ashape 数据 的 指针 ，npy_intp 实际 上 是 某 种 整数 类 型 ， 它 决定 数组 每 个 轴 
的 长 度 。 

e Sa: 指向 astrides 数据 的 指针 , 它 决定 数组 某 个 轴 上 元 素 之 间 的 间隔 (以 字 节 为 单位 )。 

e Da: 其 内 容 为 andim， 即 数组 的 维 数 ( 轴 数 )。 

ea: 数组 的 元 素 类 型 的 指针 ， 指 向 数组 a 的 数据 区 。 
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其 中 的 py_a 和 a_array 是 Python 对 象 , 直接 使 用 它们 得 不 到 特别 的 速度 提升 , 因此 在 C++ 
程序 中 需要 通过 Na、Sa、Da 和 a 等 几 个 变量 读 写 数组 。 为 了 通过 指针 a 访问 数组 中 特定 下 标 
的 元 素 ， 需 要 将 元 素 的 下 标 转换 为 相对 于 指针 a 的 偏 移 量 。 为 了 方便 程序 的 编写 ，Weave 定义 
了 4 维 以 下 数组 的 元 素 访问 宏 : A1、A2、A3 和 A4。 宏 中 使 用 下 标 和 Sa 的 值 计 算出 元 素 的 偏 
移 量 ， 注 意 这 里 的 偏 移 量 是 以 字 节 为 单位 的 ， 因 此 在 宏 中 不 直接 使 用 变量 a 进行 地 址 计算 ， 而 
是 使 用 a_array->data， 因 为 它 是 类 型 为 (char *) 的 指针 。 

下 面 的 程序 输出 这 些 信 息 : 


a weave\weave_numpy_info.py 
在 C++ 程序 中 输出 NumPy 数组 的 信息 


from scipy import weave 
import numpy as np 


def print_array_info(arr): 
weave.inline(r""" 
int i; 
printf("arr.ndim=%d\n", Darr); 
printf("arr.shape="); 
for(i=8;i<Darr;i++) 
* 
printf("%d ", Narr[i]); 
printf("\n"); 
printf("arr.strides="); 
for(i=8;i<Darr;i++) 
printf("%d ", Sarr[i]); 
printf("\n"); 
""", ["arr"], compiler="gcc") 


a = Np.arange(12).reshape(-1, 4) 
print_array_info(a) 
print_array_info(a[:,::2]) 


此 程序 的 输出 如 下 : 


arr.ndim=2 
arr.shape=3 4 
arr.strides=16 4 


arr.ndim=2 
arr.shape=3 2 
arr.strides=16 8 


Weave 还 可 以 将 NumPy 数组 转换 为 Blitz++ 数 组 ， 从 而 简化 C++ 程序 的 编写 工作 。 只 需要 
给 inline0 传 递 一 个 type_converters 关键 字 参 数 即 可 。 


Blitz++ 
Blitzt+ 是 一 个 C++ 的 科学 计算 类 库 , 它 大 量 使 用 模板 技术 来 实现 高 效率 运算 , 效率 可 以 
和 Fortran 语言 相 媲美 。 


2 http://www.oonumerics.org/blitz 
Blitz++ 的 官方 网 址 


下 面 的 语句 使 用 Blitz++ 数 组 对 NumPy 数组 a 进行 封装 ， 为 了 和 前 面 的 程序 相 区 别 ， 这 里 
我 们 先 将 数组 a 转换 为 一 个 三 维 数组 : 


>>> a.shape = 2,2,3 
>>> weave.inline(r'//',["a"], compiler="gcc", type_converters=weave.converters.blitz) 


让 我 们 看 看 扩展 之 后 的 C++ 源 程序 : 


py_a = get_variable("a",raw_locals,raw_globals); 
PyArrayObject* a_array = convert_ to_numpy(py_a,"a”"); 
conversion numpy_check_type(a_array,PyArray_LONG, "a"); 
conversion numpy_check_size(a_array,3,"a"); 

blitz: :Array<long,3> a = convert to _ blitz<long,3>(a_array, "a"); 
blitz::TinyVector<int,3> Na = a.shape(); 


我 们 得 到 了 下 面 两 个 C++ 变量 ， 它 们 的 类 型 在 Biltz++ 库 中 定义 : 
ea: 类 型 为 blitz::Array<long,3>， 它 是 一 个 元 素 类 型 为 long 的 三 维 数组 ， 通 过 它 可 以 
存 取 数组 中 的 元 素 。 
e Na: 类 型 为 blitz::TinyVector<int,3>， 它 是 一 个 元 素 类 型 为 int 的 长 度 为 3 的 向 量 , 通 
过 它 可 以 获得 数组 每 个 轴 的 长 度 。 
介绍 blitz::Array 的 用 法 已 经 超出 了 本 书 的 范围 , 读者 可 以 自行 阅读 其 文档 ,下 面 只 简单 介 
绍 如 何 存 取 数 组 中 的 元 素 。 
blitz 数组 类 覆盖 了 “0” 操 作 符 作为 元 素 存 取 用 ， 因 此 只 需要 将 一 系列 整数 传递 给 0 操作 
符 即 可 。 例 如 ，A 是 一 个 blitz 数组 对 象 ， 下 面 的 语句 可 以 对 其 中 下 标 为 (7,1,0) 的 元 素 赋值 : 


A(7,1,8) = 5; 


也 可 以 使 用 TinyVector 类 型 的 变量 存 取 数 组 中 的 元 素 ， 由 于 数组 A 是 三 维 的 ， 因 此 index 
向 量 的 长 度 也 必须 是 3: 
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TinyVector<int, 3> index; 
index = 7, 1, @; 
A(index) = 5; 


下 面 的 程序 给 数组 顺序 填写 上 递增 序列 : 


A weave\weave_numpy_blitzpy 
让 将 Numpy 数组 转换 为 Blitzt+ 数 组 


from scipy import weave 
import numpy as np 


def set_array(arr): 

weave.inline(r""" 
JE di 4 
double v = 6.9; 
for(i=6;ic<Narr(6);i++) 
for(j=6;j<Narr(1);j++) 
for(k=@;k<Narr(2);Kk++) 
1 

arr(i,j,k) = v; 

Vv += 1.0; 
i 


""", ["arr"], compiler="gcc", type_converters=weave.converters.blitz) 
a = np.zeros(12).reshape(2,2,3) 
set_array(a) 
print a 


程序 的 输出 为 : 


Eo 
3 


[E670 80] 
[ 9. 10. 11.]]] 


16.2.3 ”使 用 blitz() 提 速 


NumpPy 的 数组 运算 虽然 是 在 C 语言 级 别 进行 循环 的 ， 但 是 它 的 每 个 表达 式 在 运算 时 都 会 
产生 一 个 新 的 数组 。 因 此 在 进行 大 数组 运算 时 ， 如 果 表 达 式 很 复杂 ， 就 会 产生 许多 巨大 的 临时 
数组 ， 降 低 运算 速度 。 

weave.blitz0 可 以 将 Numpy 的 数组 运算 表达 式 编译 为 Blitz++ 的 数组 运算 程序 , 从 而 提高 数 


组 的 运算 速度 。 下 面 的 例子 计算 图 像 的 浮雕 效果 ， 每 次 运算 都 会 产生 3 个 临时 数组 : 


>>> import pylab as pl 

>>> import scipy as sp 

>>> p = sp.lena() 

>>> p.shape 

(512, 512) 

>>> el = p[:-2,1:-1] - p[2:,1:-1] + p[1:-1,:-2] - p[1:-1,2:] 


用 weave.blitz0 可 以 提高 运算 速度 并 减少 内 存 的 使 用 。 由 于 blitz0 不 能 产生 新 的 数组 , 因此 
首先 要 初始 化 一 个 数组 用 来 保存 结果 : 


>>> e2 = np.zeros((p.shape[8]-2, p.shape[1]-2), np.int32) 


然后 将 NumPy 的 数组 运算 表达 式 当做 字符 串 传递 给 blitz0。 第 一 次 运算 时 由 于 需要 进行 编 
译 ， 会 等 上 几 秒 钟 : 


>>> weave.blitz("e2 = p[:-2,1:-1]-p[2:,1:-1]+p[1:-1,:-2]-p[1:-1,2:]") 
>>> np.all(el==e2) 
True 


读者 可 能 会 怀疑 blitz0 的 运算 速度 是 否 真 的 会 比 NumPy 快 , 我 们 用 下 面 的 程序 比较 几 种 计 
算 方 法 的 速度 ， 其 中 包括 使 用 np.add0 等 函数 防止 临时 数组 变量 的 产生 。 程 序 中 为 了 使 比较 结果 
更 加 明显 一 些 , 调用 ndimage.zoom0 将 图 像 放 大 一 倍 , 并 且 将 其 元 素 转换 为 浮 点 数 , 在 调用 timeit0 
测试 时 间 之 前 ， 先 调用 一 次 blitz0， 使 其 预先 将 C++ 程序 编译 好 。 


琵 Weave\weave_blitz_speed.py 
比较 blitz0 和 NumPy 的 数组 运算 速度 


import numpy as np 

import scipy as sp 

from timeit import timeit 

from scipy import weave, ndimage 


def numpy61(p) : 
return p[:-2,1:-1] - p[2:,1:-1] + p[1:-1,:-2] - p[1:-1,2:] 


def numpy62(p) : 
el = np.zeros((p.shape[8]-2, p.shape[1]-2), np.float) 
np.subtract(p[:-2,1:-1], p[2:,1:-1] , e1) 
np.add(el，p[1:-1,:-2]，el) 
np.subtract(el，p[1:-1,2:]) 
return el 
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def blitz(p): 
e2 = np.zeros((p.shape[8]-2, p.shape[1]-2), np.float) 
weave.blitz("e2 = p[:-2,1:-1]-p[2:,1:-1]+p[1:-1,:-2]-p[1:-1,2:]") 
return e2 


p = sp.lena() 
p = ndimage.interpolation.zoom(p, 2).astype(np.float) 
blitz(p) 


if _name =="_ main_": 
import_str = "from _main import numpy81, numpy82, blitz, p” 
for s in ["numpye1", "numpy82", "blitz"]: 


print s, timeit(s+"(p)", import_str, number = 166) 
程序 的 输出 为 : 


numpye1 2.35462162538 
numpy62 2.21472983564 
blitz 1.64954585395 


可 以 看 出 ， 调 用 np.add0 等 函数 只 有 微小 的 速度 提升 ， 而 使 用 blitz0 则 能 够 提速 一 倍 。 
16.2.4 ”扩展 模块 


weave.inline0 和 weave.blitz0 都 自动 创建 扩展 模块 ,在 内 部 ， 它 们 使 用 weave.ext tools 模块 
中 提供 的 类 创建 扩展 模块 。 我 们 也 可 以 直接 使 用 ext_tools 提供 的 工具 ， 这 样 创建 的 扩展 模块 将 
保存 到 程序 运行 的 当前 文件 夹 中 ， 而 不 是 临时 文件 夹 。 

下 面 的 程序 使 用 ext_tools 创建 一 个 名 为 demo_ext 的 扩展 模块 ， 其 中 有 一 个 square0, 它 将 
二 维 数组 中 的 每 个 元 素 设置 为 其 平方 值 : 


5 weave\weave_ ext.py 
* ”使 用 weave 手工 创建 扩展 模块 


% 


from scipy import weave 
import numpy as np 


def build ext(): 
mod = weave.ext_ tools.ext_module('demo ext', compiler="gcc") © 


ext_code = r""" 

int 1 .33 
for(i=8;i<Narr(@);i++) 
for(j=0;j<Narr(1);j++) 
{ 


arr(i,j) *= arr(i,j); 


yy 


arr = np.zeros((2,2)) 
func = weave.ext tools.ext_function('square' ,ext_code,['arr'’], © 
type_converters=weave.converters.blitz) 
mod.add_function(func) © 
mod.compile() 
if _name _ == "_main_": 
try: 
import demo_ext 
except ImportError: 
build_ext() 
import demo_ext 
a = np.arange(86，168，1.9).reshape((16，16)) 
demo_ext.square(a) 
print a 


@ 首 先 使 用 ext_ module0 创 建 一 个 扩展 模块 mod。@ 然 后 使 用 ext_function0 将 C++ 程序 封 
装 成 扩展 函数 func。 在 调用 ext_function0 之 前 , 创建 了 一 个 2*2 的 临时 数组 arr, 这 样 才 能 根据 
ar 的 类 型 生成 正确 的 C+ 程序 。@ 最 后 调用 mod 的 add_function0 将 函数 添加 到 扩展 模块 中 。 
可 以 用 这 种 方法 为 扩展 模块 添加 多 个 函数 。 

最 后 在 主 程序 中 ， 先 尝试 载 入 已 经 生成 的 扩展 模块 demo_ext。 如 果 载 入 失败 ， 就 调用 
build_extO 创 建 扩展 模块 ， 然 后 再 载 入 它 。 


16.3 用 Cython 将 Python 编译 成 C 


Cython 是 为 了 减轻 使 用 C 语言 开发 Python 扩展 模块 的 负担 而 开发 出 来 的 一 种 编程 语言 。 
它 的 语法 基本 上 和 Python 相同 ， 但 增加 了 直接 定义 和 调用 C 语言 函数 、 定 义 变量 类 型 等 功能 。 
通过 Cython 的 编译 器 可 以 将 Cython 的 源 程序 编译 成 C 语言 的 源 程序 , 再 通过 C 语言 编译 器 将 
源 程 序 编译 成 扩展 模块 。 


» http://cython.org 
Cython 的 官方 网 址 


16.3.1 编译 Cython 程序 
为 了 使 用 Cython, 首先 要 选择 好 C 语言 编译 器 .在 Windows 下 可 以 选择 VC++ 或 MinGW， 
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为 了 让 Python 使 用 MinGW 作为 默认 的 编译 器 ， 请 先 编辑 文件 : 
c:\Python26\lib\distutils\distutils.cfg 


在 其 中 添加 如 下 内 容 : 


[build] 
compiler = mingw32 


Cython 的 程序 文件 以 pyx 为 扩展 名 ， 为 了 编译 它 ， 需 要 编写 一 个 “setup py” 文 件 : 


5 {cython\setup.py 
完 ”编译 Cython 程序 用 的 配置 文件 


from distutils.core import setup 

from distutils.extension import Extension 
from Cython.Distutils import build ext 
import numpy 


ext modules = [ 
Extension("mylib", ["mylib.pyx"], 
include dirs = [numpy.get_include(),'.']), 
Extension("cython_matmul", ["cython_matmul.pyx"], 
include dirs = [numpy.get_include(),'.']) 
] 


setup( 
name = "my cython library test', 
cmdclass = {'build ext': build ext}, 
ext_modules = ext_modules 

) 


在 此 程序 中 ， 指 定编 译 的 文件 为 “mylib pyx” 和 “cython_matmulLpyx”， 并 且 包 括 NumPy 
的 C 语言 头 文件 ?。 编 译 时 只 需要 运行 : 


setup.py build_ext --inplace 
就 可 得 到 编译 后 的 扩展 模块 文件 “mylibpyd” 和 “cython_ matmulpyd”。 
16.3.2 ”提高 计算 效率 
为 了 评价 Cython 的 计算 效率 ， 下 面 编写 一 组 函数 ， 计 算数 组 的 正弦 平方 和 ， 并 通过 timeit 


@ 如 果 “distutils.cfg” 文 件 不 存在 ， 新 建 一 个 。 
@ 后 面 我 们 会 看 到 如 何 使 用 Cython 处 理 NumPy 的 数组 对 象 。 


模块 测量 它们 的 计算 时 间 。 下 面 是 这 个 测试 程序 : 


A cython\cython test.py 
守 二 ”评价 各 种 计算 “正弦 平方 和 ”的 函数 的 运算 速度 


from timeit import timeit 
from math import sin 
import mylib as cy 


def py_test1(xs): 
s= 6.6 
for x in xs: 
Ss += Sin(x)**2 
return s 


def py_test2(xs): 
return sum(sin(x)**2 for x in xs) 


x= [t*0.861 for t in range(16666)] 


if _name _ == ”main 
s= "from _main import x，py_test1，py_test2，cy” 


for f in ["py_test1", "py_test2", "cy.test1", "cy.test2", "cy.test3"]: 
print f, timeit("%s(x)" % f，s，number=166) 


程序 中 定义 了 两 个 Python 函数 一 py_testl 和 py_test2， 然 后 载 入 用 Cython 编写 的 mylib 
库 ， 测 试 其 中 的 test1、test2 和 test3 三 个 函数 的 计算 时 间 。 


> # cython\mylib.pyx 
全 于 用 Cython 计算 列表 中 各 个 元 素 的 正弦 值 的 平方 和 


from math import sin as pysin 
cdef extern from "math.h": 
double sin(double x) 


def test1(xs): 
s =6.9 
Pon x in Xs 
S += pysin(x)**2 
return S 


def test2(xs): 
s=6.9 
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for x in xs: 
S += Sin(x)**2 
return s 


def test3(xs): 
cdef double s = 9.6 
or x In xs: 
s += Sin(x)**2 
return s 


程序 的 运行 结果 如 下 : 


py_test1 6.378925665182 
py_test2 6.393813566663 
cy.test1 0.379718392833 
cy.test2 6.6735996653795 
cy.test3 6.6428856451455 


用 Cython 优化 后 的 计算 速度 得 到 将 近 9 倍 的 提升 。 下 面 逐 个 分 析 “mylib pyx” 中 的 三 个 
函数 。 

首先 , test10 和 Python 版 本 的 py_testl 完全 一 样 , 使 用 pysin 作为 函数 名 是 为 了 和 后 面 的 C 
语言 的 sin 函数 相 区 别 。 而 进行 编译 之 后 没有 得 到 任何 的 效率 提升 ， 这 是 因为 它 完全 使 用 的 是 
Python 的 东西 : 变量 s 是 一 个 Python 对 象 ，pysin 是 一 个 Python 函数 。 如 果 读 者 有 耐心 查看 
“mylib pyx” 编 译 后 的 “mylib.c” 程 序 ， 就 可 以 找到 “s += pysin(x)**2” 编 译 之 后 的 一 大 堆 C 
程序 。 这 里 从 中 摘出 和 pysin 函数 调用 相关 的 两 条 语句 ， 可 以 看 出 由 于 pysin 是 一 个 Python 函 
数 ， 因 此 ， 首 先 需 要 通过 ”Pyx_GetName 获得 它 ， 然 后 再 通过 PyObject_Call 调用 它 : 


pyx_2 = _ Pyx GetName(_ pyx_m, _ pyx_kp_pysin); 
_Ppyx t 4 = PyObject Call(_ pyx 2, ((PyObject *)_pyx_t_3), NULL); 


在 test20 中 ， 我 们 调用 C 语言 标准 库 中 的 sin 函数 ，C 语言 标准 库 中 的 函数 使 用 如 下 的 语 
法 进行 声明 : 


cdef extern from "math.h": 
double sin(double x) 


在 “mylib.c” 中 可 以 找到 它 编译 之 后 的 语句 ， 注 意 这 里 直接 调用 C 语言 版 本 的 sin0: 
_Ppyx t 3 = PyFloat FromDouble(pow(sin(__ pyx_t 4), 2)); 


由 于 在 test10 和 test20 中 没有 说 明 变量 s 的 类 型 ， 因 此 在 输出 的 C 语言 程序 中 ， 它 是 一 个 
了 Python 对 象 ， 它 的 声明 及 求 和 计算 被 编译 为 如 下 语句 ， 通 过 调用 PyNumber_InPlaceAdd 实现 加 


法 运算 : 
PyObject * pyxv_s; 
a pyX Vs, PyXt 3); 
在 test30 中 ,使 用 下 面 的 语句 直接 定义 了 一 个 C 语 言 的 双 精 度 类 型 的 变量 来 保存 求 和 结果 : 
cdef double s = 6.6 


于 是 它 被 编译 成 : 


double _ pyx_v_s; 


_pyx_v_s += pow(sin(_ pyx_t_4), 2); 


到 这 里 ， 循 环 体内 部 的 运算 已 经 足够 快 了 ， 但 是 由 于 传 入 的 参数 是 一 个 Python 的 列表 对 
象 ， 即 使 是 C 语言 级 别 ， 对 列表 对 象 进行 循环 计算 的 效率 也 仍然 只 能 是 Python 级 别 的 。 为 了 
进一步 进行 优化 ， 我 们 希望 在 C 语言 级 别 对 数组 进行 循环 ， 显 然 直 接 处 理 NumPy 数组 是 提高 
速度 的 关键 所 在 。 


16.3.3 ”快速 访问 NumPy 数组 


Cython 支持 快速 访问 NumpPy 的 数组 对 象 。 为 了 优化 使 用 NumPy 数组 的 程序 ， 必 须 在 程 
序 最 前 面 使 用 cimport 载 入 NumpPy 的 pxd 文件 : 


cimport numpy as np 


Cython 中 的 pxd 文件 相当 于 C 语言 的 头 文件 ， 它 包含 Cython 的 定义 ， 使 用 cimport 关键 
字 载 入 。 读 者 可 以 在 下 面 的 文件 夹 下 找到 Cython 自 带 的 pxd 头 文件 : 


c:\Python26\Lib\site-packages\Cython\Includes 


下 面 通过 逐步 优化 矩阵 乘积 的 程序 , 介绍 在 Cython 中 如 何 快速 存 取 NumPy 数组 中 的 元 素 。 


3 办 cythonvcython_matmulpyx，cython_test_matmul py 


三 一 用 Cython 计算 矩阵 乘积 及 其 测试 程序 


首先 ， 下 面 的 matmul10 是 在 Python 级 别 进行 循环 的 矩阵 乘积 函数 ， 将 它 原 封 不 动 地 使 用 
Cython 编译 成 扩展 模块 之 后 ， 对 100*100 的 两 个 矩阵 进行 乘积 运算 ， 其 运算 时 间 为 1.3766 秒 。 


图 这 里 只 是 作为 例子 测试 Cython 的 速度 ,真正 的 矩阵 乘积 运算 请 使 用 np.dot0 计 算 。 例如 , 本 例 中 dot0 的 计算 时 间 为 0.001 秘 ， 
比 Python 版 本 快 1500 倍 。 
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直接 在 Python 下 运行 的 时 间 为 1.6183 秒 ， 只 比 Python 版 本 快 不 到 1.2 倍 。 


def matmul1(A, B, out): 
for i in range(A.shape[8]): 
for j in range(B.shape[1]): 
s=0@ 
for k in range(A.shape[1]): 
s += Ai k] * B[k, j] 
out[i,j] =s 


使 用 前 面 介绍 的 cdef 关键 字 定义 C 语言 的 局 域 变量 能 提高 运算 速度 。 下 面 将 几 个 循环 变 
量 都 定义 为 int 类 型 ,把 求 和 用 的 临时 变量 s 定义 为 double 类 型 。 因 为 它们 都 是 C 语言 的 变量 ， 
因此 计算 时 间 缩 短 为 0.98 秒 ， 速 度 是 纯 Python 版 本 的 1.6 倍 。 


def matmul2(A, B, out): 
cdef int i, j, k 
cdef double s 


前 面 两 个 函数 没有 告诉 编译 器 如 何 快速 访问 数组 ， 因 此 只 能 使 用 Python 提供 的 方法 来 访 
问 。 最 耗 时 的 数组 存 取 部 分 没 能 得 到 优化 ， 所 以 计算 速度 得 不 到 数量 级 的 改进 。 下 面 通过 声明 
三 个 参数 数组 的 元 素 类 型 和 维 数 ， 使 Cython 知道 如 何 存 取 数 组 的 元 素 ， 从 而 大 幅度 提高 计算 
速度 。matmul30 的 计算 时 间 为 0.0127 秒 ， 速 度 是 纯 Python 版 本 的 130 倍 。 


def matmul3(np.ndarray[np.float64 t, ndim=2] A, 
np.ndarray[np.float64 七 ndim=2] B， 
np.ndarray[np.float64 七 ndim=2] out): 


这 里 通过 一 种 特殊 的 Cython 语法 声明 高 效 的 数组 存 取 变 量 。 它 告诉 Cython 编译 器 : A、 
B 和 out 都 是 元 素 类 型 为 np.float64 t 的 二 维 数组 ， 其 中 的 float64 t 在 “numpypxd” 中 定义 。 
关于 此 语法 的 详细 解释 请 参考 下 面 的 链接 。 


http://wiki.cython.org/enhancements/buffer 
介绍 如 何 使 用 Cython 高 效 存 取 数 组 


| 


如 果 读 者 仔细 查看 编译 后 的 “cython_matmul.c”， 就 会 发 现 简单 的 一 行 “out[ij]=s” 被 编 
译 为 16 行 C 语言 程序 ， 其 中 绝 大 部 分 都 是 在 检测 下 标 变量 1 和 j 是 否 超出 了 out 数组 的 范围 以 
及 处 理 下 标 为 负数 的 情况 。 显然 这 种 处 理 对 于 拢 阵 乘积 的 程序 毫 无 意义 , 因此 可 以 使 用 boundscheck 
和 wraparound 两 个 修饰 ， 告 诉 编译 器 关闭 负数 下 标 处 理 和 越界 检查 。matmul40 的 运算 时 间 为 
0.0044 秒 ， 速 度 是 纯 Python 版 本 的 360 倍 。 


cimport cython 


@cython.boundscheck(False) 

@cython.wraparound(False) 

def matmul4(np.ndarray[np.float64 t, ndim=2] A, 
np.ndarray[np.float64 t, ndim=2] B, 
np.ndarray[np.float64 t, ndim=2] out): 


虽然 使 用 Cython 对 数组 存 取 进 行 优化 ， 可 以 提高 几 百倍 的 计算 速度 ， 但 是 要 注意 只 有 以 
下 两 个 条 件 满足 时 ， 通 过 Cython 才能 对 数组 存 取 进 行 优化 : 

。 下 标 数 必须 和 数组 的 维 数 一 样 多 。 

。 所 有 下 标 必须 是 C 语言 的 整 型 变量 或 整数 。 

因此 ，A 身 中、AE[i,:] 等 都 不 能 被 优化 。 并 且 如 果 变 量 i 不 使 用 cdef 声明 ，A[i.0] 将 不 能 被 
优化 。 


16.4 用 SWIG 创建 扩展 模块 


除了 使 用 Weave 和 Cython 自动 创建 扩展 模块 之 外 ,我 们 还 可 以 使 用 SWIG 为 现 有 的 C/C++ 
源 程 序 创建 Python 的 调用 接口 ， 从 而 将 其 封装 成 能 够 被 Python 使 用 的 扩展 模块 。SWIG 的 英 
文 全 称 为 Simplified Wrapper and Interface Generator， 直 接 翻 译 成 中 文 就 是 “简单 接口 生成 器 ”。 
它 是 一 个 为 C/C++ 程 序 创建 各 种 动态 语言 的 接口 的 开发 工具 ， 本 节 介绍 如 何 使 用 SWIG 为 
Python 制作 C/C++ 编 写 的 扩展 模块 。 


16.4.1 SWIG 的 调用 方法 和 实例 


假设 有 现成 的 C 语言 程序 一 一 “demo.h” 和 “demo.c”， 我 们 想 在 Python 中 使 用 上 述 程 
序 中 定义 的 变量 或 函数 ， 可 以 按照 下 面 的 步骤 进行 ， 整 个 过 程 如 图 16-1 所 示 。 

e 为 了 告诉 SWIG 需要 将 C 语言 程序 中 的 哪些 函数 和 变量 输出 到 Python 中 ， 需 要 编写 
一 个 扩展 名 为 “.i” 的 接口 文件 ， 图 16-1 中 的 文件 名 为 “demo.i”。 

e 调用 SWIG 将 接口 文件 转换 为 C 和 Python 的 两 个 源 程序 文件 ， 图 16-1 中 SWIG 通 
过 “demo.i” 生 成 “demo_wrap.c” 和 “demopy”。 

e 调用 C 语言 的 编译 器 将 “demo.h”、“demo.c” 和 “demo_wrap.c” 三 个 文件 编译 成 
Python 的 扩展 模块 “_demo.pyd”。 

e 用户 的 Python 程序 可 以 直接 调用 “_demo.pyd” 模 块 ， 或 者 通过 “demo.py” 间 接 调 
用 它 。 
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图 16-1 使 用 SWIG 创建 扩展 模块 的 流程 


通过 Python 的 标准 模块 distutils 可 以 将 上 述 编译 过 程 自动 化 ， 我 们 只 需要 编写 一 个 
“setup.py” 程 序 ,在 其 中 设置 好 编译 扩展 模块 所 需 的 文件 , 就 可 以 实现 从 源 文件 到 扩展 模块 文 
件 的 全 自动 编译 。 下 面 让 我 们 看 一 个 例子 。 


o 办 swig_demo\demo.cpp, demo.h, demo.i, setup.py 
全 一 用 SWIG 制作 扩展 模块 


个 如 果 和 希望 使 用 MinGW 作为 C 语言 编译 器 ， 请 按照 16.3.1 节 中 的 介绍 进行 配置 。 


在 “demo.c” 中 定义 了 两 个 函数 ， 在 “demo.h” 中 有 这 两 个 函数 的 调用 声明 : 


double power(double x); 
double sum power(int n); 


我 们 希望 在 Python 中 能 调用 其 中 的 sum_power0， 于 是 编写 如 下 的 “demo.i” 文 件 : 
%module demo 


%{ 
#include "demo.h" 
%} 


double sum power(int n); 


在 “demo.i” 中 ， 以 “%” 开 头 的 行 对 SWIG 有 特殊 的 意义 。 第 一 行 的 %module 命令 告诉 
SWIG 生成 一 个 名 为 demo 的 扩展 模块 。 以 “%{” 和 “%}” 括 起 来 的 部 分 将 原封 不 动 地 输出 到 
“demo_wrap.cpp” 中 ， 请 读者 在 生成 的 “demo_wrap.cpp” 中 搜索 “demo.h” 试 试看 。 最 后 一 
行 是 和 头 文件 中 一 样 的 函数 声明 ，SWIG 将 对 接口 文件 中 声明 的 所 有 函数 进行 封装 ， 使 它们 可 
以 在 Python 中 使 用 。 因 此 对 于 : 


double sum_power(int n); 


将 在 “deno_ wrap.cpp” 中 出 现 一 个 如 下 所 示 的 封装 函数 ， 也 请 读者 自行 搜索 此 函数 ， 仔 
细 分 析 封 装 函 数 的 源 代码 ， 以 了 解 SWIG 的 工作 原理 : 


SWIGINTERN PyObject * wrap_sum power(PyObject *SWIGUNUSEDPARM(self), PyObject *args) { 
// .…. 省 略 
result = (double)sum power(arg1); 
// ... 省 略 


下 面 是 自动 编译 用 的 “setup.py” 文 件 : 
from distutils.core import * 
demo_module = Extension( 

'_demo', 
['demo.i', 'demo.cpp'], 
swig opts=["-c++"] 


) 

setup( 
name = 'demo', 
version = '0.1', 
author = "HYRY Studio", 
description = """Simple swig demo""", 
ext_modules = [demo_module], 
py_modules = ["demo"] 

) 


这 段 程序 通过 Extension0 创 建 了 一 个 扩展 模块 demo， 它 由 “demo.i” 和 “demo.cpp” 两 
个 文件 构成 。 虽 然 “demo.cpp” 完 全 是 C 语言 程序 ， 但 是 为 了 演示 如 何 编译 C++ 程序 ， 这 里 通 
过 swig_opts 关键 字 将 参数 “-c++” 传 递 给 SWIG。 

在 命令 行 中 运行 下 面 的 命令 ， 就 会 产生 SWIG 的 封装 文件 “demo_wrap.cpp”， 并 且 调用 
编译 器 生成 扩展 模块 “_ demo.pyd”: 


setup.py build ext --inplace 


“ demo.pyd” 虽 然 可 以 直接 在 Python 中 使 用 ， 但 是 使 用 SWIG 提供 的 “demo.py” 更 方 
便 一 些 : 
>>> import demo 


>>> demo.sum_power(16) 
285.9 
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demo 模块 实际 上 是 由 “demo.py” 定 义 的 : 


>>> demo 
<module “demo” from “demo.py "> 


而 编译 所 得 的 扩展 模块 则 可 以 通过 demo._demo 获得 : 


>>> demo._demo 
<module " demo ”from ' demo.pyd'> 


16.4.2 SWIG 基础 


SWIG 对 接口 文件 中 声明 的 函数 和 变量 进行 封装 ,自动 生成 可 在 Python 中 调用 的 函数 。 在 
封装 函数 中 主要 进行 下 面 3 项 工作 : 

e 将 封装 函数 接收 到 的 Python 对 象 转换 为 调用 C/C++ 函数 所 需 的 值 。 

e 调用 相应 的 C/C++ 函数 。 

e 将 C/C++ 函数 的 返回 值 再 转换 为 Python 对 象 。 

由 于 Python 和 C/C++ 支持 的 数据 类 型 有 很 大 区 别 ， 因 此 有 时 这 种 转换 工作 是 比较 麻烦 的 。 
为 了 完全 理解 SWIG 的 工作 原理 , 请 读者 认真 阅读 SWIG 的 文档 。 本 节 只 对 一 些 比较 常见 的 应 
用 进行 简单 的 说 明 。 


a swig_basic\demo.cpp, demo.h, demo.i, setup.py 
< ”SWIG 的 基础 用 法 演示 


1. 指针 


SWIG 支持 C/C++ 的 指针 类 型 ，C/C++ 的 指针 在 Python 中 用 一 种 特殊 的 对 象 表示 。 例 如 在 
接口 文件 中 ， 写 入 如 下 标准 库 中 的 文件 操作 函数 声明 : 


FILE *fopen(const char *filename, const char *mode); 
int fputs(const char *, FILE *); 
int fclose(FILE *); 


在 Python 中 可 以 直接 调用 这 些 函 数 : 


>>> import demo 

>>> f = demo.fopen("test.txt", "w") 

2>> 

<Swig Object of type 'FILE ** at 6x6149D8D8> # 指针 在 Python 中 是 SwigPy0bject 对 象 
>>> demo.fputs("test file\n", f) 

8 

>>> demo.fclose(f) 

8 


在 Python 中 ， 用 SwigPyObject 类 型 的 对 象 保存 C 语言 的 指针 ， 该 对 象 记录 下 了 指针 的 类 

型 和 地 址 ， 以 便 将 其 传 回 C 语言 函数 时 使 用 。 这 些 信 息 对 于 Python 语言 来 说 几乎 是 没有 用 的 ， 
因此 在 Python 中 我 们 无 法 通过 变量 f 获 得 FILE 结构 体 中 的 内 容 。 
由 于 C 语言 不 区 分 数组 和 指针 ， 因 此 如 果 只 是 用 SwigPyObject 类 型 对 C 语言 的 数组 进行 
封装 ,那么 在 Python 中 将 无 法 通过 它 存 取 数 组 中 的 元 素 。 为 了 解决 这 个 问题 , 可 以 编写 专门 存 
取 数 组 元 素 的 函数 。 假设 用 C 语言 编写 了 下 面 4 个 函数 ， 并 通过 SWIG 将 它们 都 制作 成 扩展 
模块 : 


double * make_array(int n); // 分 配 一 个 包含 n 个 元 素 的 双 精 度数 组 

void free_array(double * x); // 释放 数组 

double get_element(double * x，int n); // 获得 数组 x 的 第 n 个 元 素 

void set_element(double * x，int n，double v) // 设置 数组 x 的 第 n 个 元 素 


在 Python 中 可 以 使 用 set_element0 和 get_element 存 取 数 组 的 元 素 : 


>>> import demo 

>>> a = demo.make_array(16) # 创建 一 个 包含 19 个 元 素 的 数组 
>>> demo.set_element(a，5，1.2) # 相当 于 a[5] = 1.2 

>>> demo.get_element(a，5) # 相当 于 a[5] 

昌之 

>>> demo.free_array(a) # 释放 数组 


如 果 没 有 定义 get_element0 和 set_element0, 也 可 以 使 用 ctypes 的 cast0 将 SWIG 指针 对 象 
转换 为 可 以 用 下 标 存 取 的 数组 。 首 先 ， 通 过 SwigPyObject 对 象 的 _longe 0 方法 获得 其 指向 的 
地 址 值 : 


>>> a = demo.make_array(16) 
>>> a._long_() # 指针 对 象 指向 的 地 址 
28867664 


调用 ctypes 的 cast0 可 以 将 地 址 转换 为 ctypes 的 指针 对 象 ， 它 的 第 一 个 参数 为 地 址 值 ， 第 
二 个 参数 为 要 转换 成 的 数据 类 型 。 下 面 语句 中 的 数据 类 型 为 ctypes.POINTER(ctypes.c_double)， 
表示 要 转换 为 一 个 指向 double 类 型 的 指针 : 


>>> import ctypes 

>>> ca = ctypes.cast(a._ long_(), ctypes.POINTER(ctypes.c_double)) 
>>> demo.set_element(a，3，2.6) # 通过 SNIG 封装 函数 设置 第 三 个 元 素 

>>> ca[3] # 通过 ctypes 指针 获得 第 三 个 元 素 

2.0 

>>> ca[2] = 166 # 通过 ctypes 指针 设置 第 二 个 元 素 

>>> demo.get_element(a，2) # 通过 SNIG 封装 函数 获得 第 二 个 元 素 

166.6 
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内 存 的 分 配 和 释放 必须 由 用 户 程序 完成 ， 并 且 没 有 数组 越界 检测 。 在 Python 中 , 使 
用 封装 函数 和 直接 使 用 C 语言 的 函数 一 样 存在 越界 的 危险 。 


显然 这 种 数组 访问 方式 完全 没有 Python 的 风格 ， 但 是 它 是 最 基本 的 解决 方案 。 后 面 我 们 
还 将 详细 介绍 如 何 通过 SWIG 实现 用 C 语言 程序 处 理 NumPy 数组 。 


2. 全 局 变量 


SWIG 不 但 可 以 对 C 语言 的 函数 进行 封装 ， 还 可 以 对 全 局 变量 进行 封装 ， 使 得 它们 的 内 容 
可 以 在 Python 中 进行 读 写 。 例 如 ， 在 “demo.cpp” 中 定义 了 一 个 全 局 变量 global_test 以 及 输出 
其 内 容 的 函数 print_global0: 


double global test = 166.6; 


void print_ global() 
printf("global_ test=%f\n", global test); 
} 


在 “demo.h” 中 ， 对 变量 和 函数 进行 声明 : 
extern double global test; 


void print_ global(); 


然后 在 接口 文件 “demo.i” 中 ， 用 下 面 的 语句 将 global_test 和 print_global0 输 出 到 Python 
的 扩展 模块 中 : 


double global test; 
void print global(); 


在 生成 的 扩展 模块 中 ， 所 有 的 全 局 变量 都 通过 模块 的 cvar 属性 进行 存 取 : 


>>> import demo 

>>> demo.cvar.global_test # 查看 全 局 变量 的 内 容 

166.6 

>>> demo.cvar.global_test *= 3 # 修改 全 局 变量 的 内 容 

>>> demo.print_global() # 用 C 语 言 的 函数 输出 全 局 变量 的 内 容 
global_test=366.966666 


3. 结构 和 类 


SWIG 会 自动 对 结构 或 类 中 的 每 个 成 员 变量 添加 存 取 函 数 , 并 输出 到 扩展 模块 中 ,在 SWIG 
输出 的 Python 模块 "中 ， 再 对 扩展 模块 中 的 函数 进行 封装 ， 让 C 语言 的 结构 类 型 能 够 像 Python 


回 在 本 例 中 ，SWIG 输出 的 模块 的 文件 名 为 “demo.py”。 


的 类 一 样 使 用 。 例 如 ， 将 下 面 的 C 语言 结构 声明 添加 到 接口 文件 “demo.i” 中 : 


struct Point 
{ 

double x, y; 
上 


在 Python 中 ， 会 将 Point 结构 封装 成 一 个 Point 类 ， 它 的 每 个 属性 都 与 结构 中 的 每 个 成 员 
变量 相对 应 : 


>>> import demo 
>>> a = demo.Point() 
>>> a.X 

8.9 

>>> a.y 

8.6 

>>> a.x = 166 
>>> a.y = 266 
>>> a.X 

166.6 

>>> a.y 

266.6 


也 可 以 直接 调用 扩展 模块 中 的 函数 : 


>>> demo._demo.Point x get(a) 
166.6 


实际 上 ， 如 果 读 者 阅读 “demopy” 中 的 程序 就 会 发 现 : Point 内 属性 x、y 的 存 取 都 会 调 
用 Point x_get、Point x_set、Point y_get、Point_y_set 等 函数 。 而 在 “demo_wrap.cpp” 中 ， 可 
以 找到 它们 对 应 的 C 语言 函数 : 


SWIGINTERN PyObject * wrap_Point x_get(PyObject *SWIGUNUSEDPARM(self), PyObject *args) 
+‘ 

// .省 略 . .. 

result = (double) ((argl)->x); // 《<- 整个 函数 的 目的 就 是 封装 这 一 句 

// ... 省 略 ... 
} 


和 成 员 变量 相似 , 对 于 类 的 成 员 函 数 , SWIG 也 会 进行 类 似 的 封装 ,例如 对 于 下 面 的 CPoint 
类 的 成 员 函 数 power0: 


class CPoint 


ii 


由 泛 糙 于 驯 菠 叫 育 9 再 


| 561 


贡 洗 烘 玫 巴 薄 串 育 9 性 


562 


Python 科学 计算 


public: 
double x, y; 
double power(); 
上 


在 Python 中 可 以 如 下 调用 : 


>>> import demo 
>>> p = demo.CPoint() 


>>> p.x = 3 
>>> p.y = 4 
>>> p.power() 
25.6 


查看 “demo.py” 中 的 源 代码 ， 可 以 找到 : 


class CPoint(_object): 
# 。。. 省 略 ..。 
def power(self): return _demo.CPoint power(self) 


而 在 “demo_wrap.cpp” 中 ， 可 以 找到 CPoint_power0 对 应 的 封装 函数 : 


SWIGINTERN PyObject * wrap_CPoint_ power(PyObject *SWIGUNUSEDPARM(self), PyObject *args) 
{ 

// .省 略 ... 

result = (double)(arg1)->power(); 

// …. 省 略 ... 


4. 类 型 映射 


SWIG 的 主要 任务 就 是 自动 生成 一 个 封装 函数 , 在 C/C++ 函数 参数 和 Python 函数 参数 之 间 
进行 相互 转换 。 它 的 所 有 转换 规则 都 可 以 使 用 类 型 映射 (Typemaps) 进 行 定义 。SWIG 已 经 提供 
了 许多 默认 的 类 型 映射 定义 。 因 此 在 前 面 的 例子 中 ， 我 们 完全 没有 意识 到 它 的 存在 。 但 有 时 为 
了 让 封装 函数 更 接近 Python 的 习惯 ， 需 要 使 用 类 型 映射 对 封装 函数 的 参数 进行 修改 。 

例如 ，C 语言 的 函数 无 法 返回 多 个 值 ， 因 此 通常 的 做 法 是 采用 指针 实现 这 一 目的 : 


void add mult(double x, double y, double * s, double *p) 
*s=X+y; 
A 


lj 
如 果 直 接 使 用 SWIG 对 add_mult0 进 行 封装 ， 将 无 法 通过 函数 的 声明 分 析出 指针 s 和 p 只 


是 为 了 返回 值 , 因此 最 终 的 Python 函数 也 需要 有 4 个 参数 , 并 且 后 两 个 参数 是 指针 类 型 的 对 象 ， 
这 样 的 函数 在 Python 中 很 不 好 用 。 我 们 可 以 通过 类 型 映射 改变 SWIG 的 默认 行为 ， 如 果 告 诉 
SWIG 指针 s 和 p 只 是 为 了 返回 值 ， 那么 SWIG 产生 的 Python 函数 只 需要 两 个 参数 ， 并 且 将 两 
个 返回 值 用 列表 返回 。 类 型 映射 用 起 来 很 简单 ， 只 需要 在 接口 文件 “demo.i” 中 对 add_mult0 
进行 如 下 声明 : 


void add mult(double x, double y, double * OUTPUT, double *OUTPUT); 


其 中 ,“double *OUTPUT” 不 但 是 函数 的 参数 说 明 ， 它 还 是 一 个 已 经 定义 的 类 型 映射 ， 它 
告诉 SWIG 这 个 double 指针 参数 是 用 来 输出 值 的 。 如 果 和 希望 在 函数 声明 中 保留 原来 的 参数 名 ， 
可 以 使 用 “%apply” 命 令 将 类 型 映射 运用 到 指定 名 称 的 参数 之 上 。 下 面 的 定义 先 将 类 型 映射 

“double *+OUTPUT” 运 用 到 参数 “double *s” 和 “double *p” 之 上 。 由 于 “%apply” 的 作用 会 
一 直 有 效 ， 因 此 如 果 希 望 结束 对 指针 s 和 Dp 的 类 型 映射 ， 就 需要 使 用 “%clear” 进 行 清除 : 


%apply double *OUTPUT { double *s, double *p }; 
void add mult(double x, double y, double * s, double *p); 
%clear double *s, double *p; 


这 样 一 来 ， 在 Python 中 add_mult0 的 调用 就 变 得 很 直观 了 : 


>>> import demo 
>>> demo.add_mult(3,4) 
[7.86，12.6] 


除了 OUTPUT 之 外 , 还 有 INPUT 和 INOUT 等 常用 的 类 型 映射 。INPUT 将 C 语言 的 指针 
变量 转换 为 Python 中 它 所 指向 的 类 型 。 例 如 下 面 的 add0 要 求 其 两 个 参数 为 指向 double 类 型 的 
指针 ， 默 认 情 况 下 ， 在 Python 中 它 是 用 SwigPyObject 类 型 的 指针 对 象 来 表示 。 但 是 我 们 希望 
add0 能 直接 接受 浮 点 数值 进行 运算 ， 因 此 可 以 使 用 INPUT 类 型 映射 : 


double add(double *INPUT, double *INPUT); 
在 Python 中 可 以 直接 将 能 转换 为 浮 点 数 的 对 象 传递 给 add0， 而 不 再 需要 用 指针 对 象 : 


>>> demo.add(4,5) 
9.0 


有 时 候 ，C 语言 中 指针 类 型 的 参数 同时 起 到 输入 和 输出 的 作用 ， 例 如 下 面 的 nc0， 它 将 其 
参数 指针 指向 的 变量 值 增加 1: 


void inc(int *INOUT); 


由 于 Python 中 的 整数 对 象 是 不 可 变 的 ， 因 此 Python 中 的 inc0 无 法 直接 更 改 其 参数 对 象 的 
值 。 这 时 可 以 使 用 NOUT 类 型 映射 ， 它 告诉 SWIG 此 参数 的 值 在 函数 中 参与 运算 ， 并 且 它 的 
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值 会 被 更 新 ， 以 返回 值 的 形式 返回 新 的 值 : 


>>> demo.inc(4) 
5 


如 果 希 望 用 它 来 更 新 某 个 变量 的 值 ， 只 能 将 同一 变量 重新 绑 定 为 inc0 所 返回 的 值 : 


>>> X = 了 2 

>>> x = demo.inc(x) 
>>> X 

3 

5. 函数 指针 


在 C 语言 中 ， 可 以 使 用 函数 指针 将 函数 作为 参数 传递 ; 在 SWIG 中 ， 可 以 将 C 语言 的 函 
数 封装 成 一 个 Python 的 指针 对 象 ， 并 在 Python 中 将 它 传递 给 别 的 C 语言 函数 ， 实 现 函 数 指针 
的 传递 。 

例如 , 在 下 面 的 C 语言 程序 中 , sum_fonc0 的 第 一 个 参数 是 函数 指针 , 此 外 还 定义 有 square0、 
ieciprocal0 和 linear0 三 个 函数 ， 它 们 可 以 作为 函数 指针 传递 给 sum_func0: 


double sum func(double (*op)(double), int s, int e) 
ul 

double sum = @; 

int i; 

for(i=s;ice;i++) 

{ 

Sum += (*op)(i); 
F 
return sum; 


: 


double square(double x) 


return x*x; 


double reciprocal(double x) 
a 


return 1/x; 
} 


double linear(double x) 
t 


return @.5*x+1; 


} 


如 果 直 接 将 square0 等 三 个 函数 声明 放 到 接口 文件 中 ， 就 会 生成 三 个 封装 函数 ， 而 不 是 它 
们 的 指针 。 为 了 让 SWIG 同时 生成 函数 指针 对 象 和 封装 函数 ， 可 以 使 用 “%callback” 命 令 : 


double sum func(double (*op)(double), int s, int e); 


%callback("cb %s"); 

double square(double x); 
double reciprocal(double x); 
double linear(double x); 
%nocallback; 


对 于 在 “%callback” 和 “%nocallback” 中 包围 的 函数 声明 ， 将 同时 生成 其 封装 函数 和 函 
数 指针 对 象 。 为 了 解决 二 者 的 命名 冲突 问题 ， 通 过 “%callback” 命 令 的 参数 “cb_%s”， 可 以 
指定 函数 指针 对 象 名 的 格式 化 字符 串 。 因 此 对 于 square0, 它 所 对 应 的 指针 对 象 就 是 cb_square: 


>>> import demo 

>>> demo.reciprocal(16) # 直接 调用 封装 函数 
8.166666666666686661 

>>> demo.reciprocal # 类 型 为 函数 

<built-in function reciprocal> 

>>> demo.sum_func(demo.cb_reciprocal，1，166) # 用 函数 指针 对 象 将 函数 作为 参数 传递 
5.1773775176396288 

>>> import numpy as np 

>>> np.sum( 1.6/np.arange(1,166)) # 验证 结果 
5.1773775176396288 

>>> demo.cb_reciprocal # 类 型 为 指针 对 象 

<Swig Object of type “double (*)(double)”at 6x66E3F818> 


6. 回调 Python 函数 


使 用 函数 指针 ， 只 能 将 C/C++ 语言 的 函数 经 过 Python 中 转 之 后 再 传递 给 C/C++ 语言 的 函 
数 ， 无 法 实现 C/C++ 语言 程序 调用 Python 函数 。 前 面 介绍 过 ，C++ 的 类 可 以 被 封装 成 Python 
的 类 ， 并 且 在 Python 中 还 可 以 继承 此 封装 类 。 但 是 默认 情况 下 ，C++ 的 类 无 法 获知 Python 类 
的 继承 情况 ， 因 此 在 C++ 类 中 定义 的 虚 函 数 ， 无 法 通过 其 多 态 性 调用 Python 子 类 中 的 实现 函 
数 。 为 了 实现 C++ 调用 Python, 我 们 需要 开启 “Director” 功 能 一 一 为 接口 文件 的 第 一 行 “%module” 
命令 添加 参数 directors="1": 


Xmodule(directors="1") demo 


然后 , 对 于 希望 调用 Python 函数 的 C++ 类 Foo, 通过 “%feature” 命 令 开启 它 的 “Director” 
功能 : 


%feature("director") Foo; 
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下 面 仍 然 以 函数 值 求 和 为 例 ， 介 绍 如 何 实现 C++ 调用 Python。 在 文件 “demoh” 中 ， 计 算 
求 和 的 C++ 类 的 源 程序 如 下 ,其 中 FuncO 是 一 个 虚 函 数 , 我 们 希望 在 Python 的 子 类 中 通过 覆盖 
它 实现 不 同 数学 函数 的 求 和 计算 : 


class Sum 
ii 
public: 
double Cal(int s, int e) 
{ 
double sum = @; 
for(int i=s;ice;i++) 
sum += Func(i); 
return sum; 
} 
virtual double Func(double x){return x;} 


上 
通过 修改 “demo.i” 的 第 一 行 ， 开 启 “Director” 功 能 ， 并 添加 如 下 的 Sum 类 的 声明 : 


%feature("director") Sum; 
class Sum 
1 
public: 
double Cal(int s, int e); 
virtual double Func(double x); 
}; 


编译 成 扩展 模块 之 后 ， 在 Python 中 可 以 按 如 下 方式 使 用 Sum 类 ; 


>>> import demo 
>>> demo.Sum().Cal(1,161) # 直接 使 用 Sum 类, 计算 1 到 189 的 和 
5656.6 
>>> class SumReciprocal(demo.Sum): # 定义 Sum 的 子 类 
def Func(self，x): # 覆盖 其 Func() 虚 函数 


return 1.6/x 


>>> SumReciprocal().Cal(1，166) # 计算 1 到 99 的 倒数 的 和 
5.1773775176396288 


16.4.3 ”SWIG 处 理 NumPy 数组 


用 C 语言 编写 扩展 模块 的 最 重要 目的 就 是 提高 数组 运算 的 效率 ， 因 此 我 们 希望 SWIG 能 
够 方便 地 处 理 NumPy 数组 。 标 准 的 SWIG 并 不 支持 NumpPy 数组 ， 需 要 下 载 一 个 NumPy 的 接 


口 文件 “numpyi”， 读 者 也 可 以 在 本 节 的 示例 程序 文件 夹 下 找到 它 。 


http://projects.scipy.org/numpy/browser/trunk/doc/swig 
从 此 链接 下 载 Numpy 的 SWIG 接口 文件 “numpy:i” 


| 


有 swig_numpy\demo.cpp, demo.h, demo.i, setup.py 
全 < 用 SWIG 编写 处 理 NumPy 数组 的 扩展 模块 


为 了 在 扩展 模块 中 处 理 NumPy 数组 ， 接 口 文件 “demo.i” 中 必须 有 如 下 内 容 : 
%nmodule demo 


%{ 
#define SWIG_FILE_WITH_INIT 
#include “demo.h” 

%} 


%include “numpy.i" 


%init %{ 
import_array(); 
%} 


用 “%init” 命 令 括 起 来 的 内 容 ， 将 输出 到 扩展 模块 的 初始 化 函数 SWIG_init0 中 。 而 为 了 
在 其 中 调用 import_array0， 还 需要 定义 : 


#define SWIG_FILE WITH_INIT 


由 于 扩展 模块 使 用 了 Numpy, 它 需要 引用 NumpPy 的 C 语言 的 头 文件 , 因此 在 文件 “setuppy” 
中 指定 NumPy 的 头 文件 的 位 置 : 


demo_module = Extension( 
'_demo', 
['demo.i', 'demo.cpp'], 
include dirs = [numpy.get_include()], 
swig opts=["-c++"] 


) 


按照 上 面 的 步骤 设置 好 接口 文件 “demoi” 和 “setup py” 之 后 , 就 可 以 正常 编译 处 理 NumPy 
数组 的 扩展 模块 了 。 

在 “numpyi” 中 定义 了 许多 类 型 映射 以 实现 各 种 参数 转换 要 求 。 例如 对 于 下 面 的 drange0， 
我 们 希望 在 Python 中 它 和 arange0 的 功能 一 样 : 
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void drange(double * x, int n) 


浊 
for(int i=6;i<n;ji++) x[i] = i; 


} 


因为 drange0 的 数组 参数 x 只 作为 输出 数据 用 ， 所 以 可 以 使 用 类 型 映射 将 此 函数 改 为 返回 
一 个 数组 ， 下 面 是 接口 文件 中 drange0 的 声明 : 


void drange(double * ARGOUT_ARRAY1, int DIM1); 
扩展 模块 中 drange0 的 调用 方法 如 下 : 


>>> import demo 
>>> demo.drange(16) 
LE 2 和 ES 


所 返回 的 数组 的 内 存 分 配 工作 由 “demo_wrap.cpp” 中 的 封装 函数 完成 。 这 里 用 到 的 类 型 
映射 为 DATA_TYPE* ARGOUT_ARRAY1, DIM_TYPE DIM1), 类 型 映射 可 以 对 连续 的 多 个 参 
数 进行 类 型 转换 。ARGOUT_ARRAY1 表示 此 参数 数组 将 作为 函数 返回 值 ， 并 且 它 是 一 维 的 。 
读者 可 以 在 文件 “numpy:i” 中 找到 它 的 定义 ， 并 且 可 以 在 此 文件 中 找到 它 所 支持 的 所 有 类 型 映 
射 的 说 明 ®。 

例如 ， 可 以 找到 一 个 返回 固定 大 小 的 二 维 数组 用 的 类 型 映射 一 -ARGOUT ARRAY2[ANY] 
[ANY]。 下 面 的 例子 用 它 返 回 二 维 空间 中 的 旋转 矩阵: 


void rot2d(double x[3][3], double th) 


{ 
x[8][2] = 8; x[1][2] = 8@; x[2][8] = 6; x[2][1] = @; 
x[8][8] = cos(th); x[6][1] = -sin(th); x[1][8] = sin(th); x[1][1] = cos(th); 
x[2][2] = 1; 

} 

在 接口 文件 中 使 用 如 下 的 定义 : 


void rot2d(double ARGOUT_ARRAY2[3][3], double th); 
在 Python 中 ，rot2d0 的 使 用 方法 为 : 


>>> demo.rot2d(np.pi/4) 


array([[ 8.706710678, -0.70710678， 8. 让 
[ 8@.78716678， 8.76719678， 8. 
Le 0 1 ]]) 


在 “numpyi” 中 搜索 “9%numpy_typemaps0O macro” 可 以 快速 找到 它 。 


在 “numpyi” 中 找 不 到 返回 二 维 数组 的 内 存 映射 (DATA_TYPE* ARGOUT ARRAY2， 
DIM_TYPE DIM1, DIM_TYPE DIM2)。 因 此 如 果 需 要 返回 可 指定 大 小 的 二 维 数组 ， 只 能 先 如 
drange0 一 样 得 到 一 个 一 维 数 组 ， 然 后 在 Python 中 将 其 形状 修改 为 二 维 ， 或 者 使 用 后 面 将 要 介 
绍 的 INPLACE_ARRAY2 类 型 映射 。 

用 IN_ARRAY 相关 的 类 型 映射 表示 参数 只 作为 输入 数据 使 用 。 由 于 在 封装 函数 中 会 对 参 
数 进行 类 型 转换 ， 因 此 在 Python 中 调用 时 ， 可 以 给 它 传递 任意 的 序列 对 象 ， 只 要 此 序列 对 象 的 
元 素 都 能 够 正确 地 转换 为 函数 所 需 的 数据 类 型 即 可 。 例 如 ， 对 于 下 面 的 求 平方 和 函数 : 


double sum power(double * x, int n) 

{ 
double sum = 9; 
for(int i=6;i<n;ji++) sum += x[i]*x[i]; 
return sum; 


在 接口 文件 中 使 用 下 面 的 定义 : 


double sum power(double * IN_ARRAY1, int DIM1); 
在 Python 中 ， 可 以 如 下 使 用 sum_power0: 


>>> demo.sum_power([1,2,3]) # 可 以 对 列表 进行 计算 
14.6 

>>> x = np.arange(16.6) 

>>> demo.sum_power(x[::2]) # 数组 的 元 素 可 以 不 是 连续 的 
126.6 


显然 用 IN_ARRAY 进行 类 型 映射 时 ， 在 封装 函数 内 部 会 产生 一 个 临时 数组 用 来 保存 输入 
序列 中 的 每 个 元 素 ， 而 实际 的 C 语言 函数 则 对 这 个 临时 数组 中 的 元 素 进 行 计算 。 

用 INPLACE ARRAY 表示 数组 的 内 容 将 会 被 C 语言 程序 更 新 ， 因 此 Python 所 传递 的 参 
数 必须 是 NumPy 数组 ， 其 元 素 类 型 和 C 语言 的 对 应 参数 类 型 必须 一 致 ， 并 且 数组 元 素 必须 占 
用 连续 的 内 存 空间 。 例 如 下 面 的 powerO 计 算数 组 中 每 个 元 素 的 平方 : 


void power(double *x, int n) 
for(int i=@;i<n;i++) x[i] *= x[i]; 
} 


其 接口 定义 为 : 


void power(double *INPLACE ARRAY1, int DIM1); 
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在 Python 中 : 


>>> a = np.arange(16.9) 

>>> demo.power(a) 

>>> a 
ET 

>>> demo.power([1,2,3]) # 参数 不 能 是 列表 

[[ 省 略 ]] 

TypeError: Array of type “double” required. A 'list' was given 

>>> demo.power(a[::2]) # 元 素 位 置 不 连续 的 数组 也 不 行 

[[ 省 略 ]] 

TypeError: Array must be contiguous. A non-contiguous array was given 


可 以 看 出 使 用 INPLACE_ARRAY 时 ，C 语言 函数 所 处 理 的 就 是 NumPy 数组 的 数据 存储 
区 ， 由 于 我 们 没有 将 Numpy 数组 的 strides 属性 传递 给 C 语言 函数 ， 因 此 它 只 能 处 理 连续 存储 
的 数组 。 


自 适应 滤波 器 


近年 来 ， 随 着 数字 信号 处 理 器 功能 的 不 断 增强 ， 自 适应 信号 处 理 (adaptive signal process) 经 
常用 于 噪声 消除 、 回 声控 制 、 信 号 预测 、 声 音 定位 等 众多 的 信号 处 理 领 域 。 

本 章 简要 介绍 自 适应 滤波 器 的 原理 及 其 最 常用 的 算法 NLMS, 并 使 用 纯 Python 实现 NLMS 
算法 , 在 此 基础 上 我 们 对 自 适应 滤波 器 的 各 种 应 用 做 了 一 些 模拟 计算 。 最 后 为 了 提高 运算 速度 ， 
我 们 用 SWIG 和 Weave 对 C 语言 的 NLMS 程序 进行 封装 。 


17.1 自 适应 滤波 器 简介 


对 于 许多 数字 信号 处 理 方面 的 应 用 来 说 ， 由 于 事先 并 不 知道 系统 的 一 些 参数 ， 例 如 噪声 的 
特性 、 未 知 系统 的 传递 函数 等 等 ， 因 此 经 常 需要 滤波 器 能 够 根据 输入 信号 自动 调节 其 参数 以 进 
行 数字 滤波 。 

随 着 数字 信号 处 理 芯片 (DSP) 的 性 能 不 断 增 强 ， 自 适应 滤波 器 已 经 广泛 应 用 于 通信 、 电 子 、 
交通 、 医 疗 等 各 个 领域 。 尽 管 其 应 用 领域 十 分 广泛 ， 但 基本 的 系统 构造 大 致 可 分 为 系统 识别 、 
信号 预测 、 信 号 均衡 等 几 种 。 


17.1.1 系统 识别 


所 谓 系统 识别 (system identification)， 是 指 通过 对 未 知 系统 的 输入 和 输出 信号 进行 观测 ， 构 
造 一 个 滤波 器 使 得 它 在 相同 输入 信号 的 情况 下 ， 输 出 信号 和 未 知 系统 相同 。 简 而 言 之 ， 就 是 通 
过 观测 未 知 系统 对 输入 信号 的 反应 ， 探 知 其 内 部 情况 。 为 了 探知 内 情 而 使 用 的 输入 信号 ,我们 
称 之 为 参照 信号 。 

如 图 17-1 所 示 ， 参照 信 号 x (j ) 同 时 输入 到 未 知 系统 和 自 适应 滤波 器 了 H 中 ， 未 知 系统 的 输 
出 为 y(j)， 自 适 应 滤波 器 的 输出 为 (j )。 由 于 观测 误差 或 受 外 部 噪声 的 和 干扰， 实际 观测 到 的 
未 知 系统 的 输出 为 d(j )=y(j)+n(j),n(j ) 被 称 为 外 部 干扰 .d(j) 和 nu (j ) 之 间 的 误差 e(j)= 
d(j)-u(j)， 也 就 是 自 适 应 滤波 器 也 的 输出 和 未 知 系统 的 输出 之 间 的 误差 ， 通 过 这 个 误差 我 
们 更 新 瑟 的 内 部 系数 ， 使 得 它 的 输出 更 加 靠近 未 知 系统 的 输出 。 
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17-1 系统 识别 的 系统 框图 


上 面 各 个 公式 中 的 j 表示 某 一 时 刻 ， 由 于 我 们 讨论 的 是 数字 信号 处 理 ， 已 经 对 所 有 的 信号 
进行 了 取样 ， 因 此 可 以 把 j 简单 地 看 做 取样 后 信号 数据 的 下 标 。 


17.1.2 ”信号 预测 
所 谓 信号 预测 ， 就 是 通过 信号 过 去 的 值 计算 现在 的 值 ， 图 17-2 是 信号 预测 的 系统 框图 。 
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17-2 信号 预测 的 系统 框图 


dfj) e( 了 ) 
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py 


x (j) 是 待 测 信号 ， 假 设 我 们 无 法 完美 地 观测 此 信号 ， 因 此 导入 一 个 外 部 干扰 n(j )。 这 样 
一 来 ，d(j)=x(j)+n(j) 就 是 我 们 观测 到 的 待 测 信号 。 

通过 延迟 器 将 d(j ) 进 行 延 时 得 到 d(j - D)， 并 把 d (j DD) 输入 到 自 适应 滤波 器 也 中 ， 得 
到 其 输出 为 u(j )，u (j ) 就 是 自 适 应 滤波 器 通过 待 预测 信号 过 去 的 值 预测 到 的 现在 的 值 ， 计 算 
观测 值 4(j ) 和 预测 值 a(j ) 之 间 的 误差 e(j)=d(j)-u(j)， 通 过 e(j) 更 新 自 适应 滤波 器 互 的 
内 部 系数 ， 使 得 其 输出 更 加 接近 d (j )。 

如 果 x (j ) 存 在 白 噪声 的 成 分 和 周期 信号 的 成 分 ， 那 么 由 于 白 噪声 是 完全 随机 、 无 法 预测 
的 信号 ， 因 此 用 过 去 的 值 x4- D) 所 能 预测 的 只 能 是 其 中 的 周期 信号 的 成 分 。 这 样 一 来 ， 自 适 
应 滤波 器 五 的 输出 信号 u(j ) 就 会 与 周期 信号 成 分 渐渐 逼近 ,而 e(j ) 则 是 剩 下 的 不 可 预测 的 白 
噪声 的 成 分 。 因 此 自 适应 滤波 器 也 可 以 应 用 于 噪声 消除 。 


17.1.3 “信号 均衡 
如 图 17-3 所 示 ， 当 信号 x (j ) 通 过 未 知 系统 后 变 成 了 y (j )， 未 知 系统 对 信号 x (j ) 进 行 了 


某 种 改变 ， 使 得 其 波形 产生 牌 曲 。 我 们 希望 通过 均衡 器 矫正 这 种 牌 曲 ， 也 就 是 通过 y (j ) 重 建 
原始 信号 x (j)， 由 于 因果 律 ， 还 原 原 始 信号 x (j ) 是 不 可 能 的 ， 我 们 只 能 还 原 其 延 时 了 的 信号 
x(j 一 D)。x(j) 和 x(j 一 DD) 除了 时 间 上 的 延迟 之 外 ， 其 他 特性 完全 相同 。 


x(j) d(j)-x(j-0) 
[| 


| JE el) 
未 知 系统 ”一 + 自 适应 让 渡 胃 一 + 
H(j) 
| 
系数 更 新 算法 


17-3 ”信号 均衡 的 系统 框图 


这 里 我 们 将 观测 到 的 未 知 系统 的 输出 yY(j )+n (j ) 输 入 到 自 适 应 滤波 器 五 中 , 通过 了 H 的 系 
数 更 新 使 得 其 输出 u (j ) 逐 渐 逼 近 原始 信号 的 延 时 xG4- D)。 这 样 一 来 ， 我 们 就 构建 了 一 个 滤波 
器 互 ， 使 得 它 与 未 知 系统 的 卷 积 正好 等 于 一 个 脉冲 传递 函数 。 也 就 是 说 ， 互 的 频 域 特 性 恰好 能 
抵消 未 知 系统 所 带 来 的 改变 。 


17.2 NLMS 计算 公式 


自 适 应 滤波 器 中 最 重要 的 一 个 环节 就 是 其 系数 的 更 新 算法 , 如 果 不 对 自 适应 滤波 器 的 系数 
更 新 ， 那 么 它 就 只 是 一 个 普通 的 滤波 器 了 。 系 数 更 新 算法 有 很 多 种 ， 最 简单 的 一 种 方法 叫做 
NLMS( 归 一 化 最 小 均 方 )， 让 我 们 先 看 看 它 的 数学 公式 表达 。 

设置 自 适 应 滤波 器 系数 h 的 所 有 初始 值 为 0， 假 设 h 的 长 度 为 了。 


h(0)=0 
对 每 个 取样 值 进行 如 下 计算 ， 其 中 n=0, 1,2,… 
x(n) =[x(m),x(n—D),.., x(n -T+D] 
em) =d(m) -nh (mx(n) 


He(m)x(n) 
hn+D)=A(n)+ a 


自 适 应 滤波 器 系数 是 一 个 长 度 为 1 的 矢量 ， 也 就 是 一 个 长 度 为 1 的 FIR 滤波 器 。 在 时 刻 
n， 滤 波 器 对 应 的 输入 信号 为 x(m), 它 也 是 一 个 长 度 为 1 的 矢量 。 这 两 个 矢量 的 点 乘 即 为 滤波 器 
的 输出 。 它 和 目标 信号 df 之 间 的 差 为 e(m)， 然 后 根据 e(w 和 x()， 更 新 滤波 器 的 系数 。 

数学 公式 总 是 令 人 难以 理解 的 ， 下 面 我 们 以 图 17-4 为 例 进行 说 明 。 
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Pemaorx™ x[4]"x[#]+...+x[7]*x[7] 
人 


乱 焉 业 号 x /一 一 


xE@] | x[i] | x[2] | x[3] | x[4] | x[S] | x[6] | x[7] | x[8] | x[9] | x[19] [13 四 


h[3] h[2] NI nie] ) 自 返 应 江波 器 系 财 H 
LU 
自 适应 光波 周 的 榆 出 =- 


训 
ufe@] | wWfi] | wu[2] | u[3] | vt4] | vI5] ，u[6] ur7] 上 auf7]=hfe]*x[7]+,-+h[3]*x[4] 


观测 的 未 知 系 统 的 输出 


dfe] | dl3] | df2] | dl3] | dl4] | dl5] | dlé] | dl7] 
TE 


再 


efe] | efi] | of2] | ef3] | af4] | efs] | sf6] | es[7] 
| | 


x[4] x[5] x[é] | x[7] 


a[7]"d[7]-u[7) 


ea 三 h[e@]=h[8]+b wef7]*xT7]/powerX 


- - 
更新 之 后 的 系数 hf3] | hf[z] | h[2] | h[e] ae 


h[3]=h[3]+b “ef7]*x[4]/powerx 
图 174 NLMS 算法 示意 图 


17-4 中 假设 自 适应 滤波 器 卫 的 长 度 为 4， 在 时 刻 7 滤波 器 的 输出 为 : 


uf7] = h[e]*x[7] + h[1]*x[6] + h[2]*x[5] + h[3]*x[4] 
滤波 器 的 输入 信号 的 平方 和 powerX 为 : 

powerX = x[4]*x[4] + x[5]*x[5] + x[6]*x[6] + x[7]*x[7] 
未 知 系统 的 输出 d[7] 和 滤波 器 的 输出 u[7] 之 间 的 差 为 : 


e[7] = d[7] - u[7] 


使 用 e[7] 和 x[4] 到 x[7] 对 滤波 器 的 系数 进行 更 新 : 


h[3] = h[3] + u * e[7]*x[4]/powerX 
h[2] = h[2] + u * e[7]*x[5]/powerX 
h[1] = h[1] + u * e[7]*x[6]/powerX 
h[e] = h[8] + u * e[7]*x[7]/powerX 


对 于 每 个 取样 值 都 需要 进行 上 述 计算 。 参 数 u 为 更 新 系数 ， 取 值 范 围 一 般 在 0~1 之 间 。 值 
越 大 ， 系 数 更 新 的 速度 越 快 。 


17.3 用 NumPy 实现 NLMS 算法 


按照 刚才 介绍 的 NLMS 算法 ， 很 容易 写 出 用 NumpPy 实现 的 NLMS 程序 : 


4 nlms numpy.py 
守 用 Numpy 实现 NLMS 算法 


import numpy as np 


# 用 NumPy 实现 NLMS 算法 
# X 为 参照 信号 ，d 为 目标 信号 ，h 为 自 适应 滤波 器 的 初 值 
# step_size 为 更 新 系数 
# 返回 自 适 应 滤波 器 的 输出 信号 
def nlms(x，d，h，step_size=6.5): 
count = min(len(x), len(d)) © 
u = np.zeros(count, dtype=np.float64) 


nh = len(h) 
# 计算 输入 到 h 中 的 参照 信号 的 平方 和 
power = np.sum( x[:nh] **2 ) @ 


i=nne® 
while True: 
x_input = x[i:i-nh:-1] @ 
u[i] = np.dot(x_input , h) 
e = d[i] - u[i] 
h += step_size * e / power * x_input 
# 减 去 最 早 的 取样 
power -= x_input[-1] * x_input[-1] 
i+=1 
if i >= count: return u 
# 增加 最 新 的 取样 


power += x[i] * x[i] 


nlms0 的 输入 为 参照 信号 x、 目 标 信 号 d 和 自 适应 滤波 器 的 初始 系数 h, 返回 自 适应 滤波 器 
的 输出 信号 u， 并 且 更 新 系数 h。 

@ 首 先 取 x 和 d 中 较 小 的 长 度 作为 循环 的 次 数 count， 并 且 用 它 初始 化 保存 滤波 器 输出 信 
号 的 数组 u。@ 为 了 节省 计算 时 间 ， 我 们 用 一 个 临时 变量 power 保存 输入 到 滤波 器 h 中 的 参照 
信号 x 的 能 量 。 在 对 x 中 的 每 个 取样 值 进行 循环 时 ， 只 需要 从 power 中 减 去 x 中 最 早 的 一 个 取 
样 值 的 平方 ， 加 上 最 新 的 取样 值 的 平方 ， 就 能 保证 power 始终 等 于 输入 信号 的 平方 和 。 这 样 一 
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来 ， 每 次 循环 只 需要 计算 两 次 乘法 和 两 次 加 法 即 可 。@ 循 环 变量 i 的 初始 值 本 来 可 以 从 nh 一 1 
开始 ， 但 是 为 了 让 @ 处 的 i 一 nh 不 为 负 ， 我 们 让 循环 变量 从 nh 开始 。 
为 了 对 自 适应 滤波 器 的 各 种 应 用 进行 模拟 ， 我 们 还 需要 如 下 的 几 个 辅助 函数 。 


a nlms common.py 
自 适应 滤波 器 模拟 的 辅助 函数 库 


import numpy as np 
import pylab as pl 


# 随机 产生 FIR 滤波 器 的 系数 ， 长 度 为 length， 延 时 为 delay， 指 数 衰 减 
def make_path(delay, length): 
plen = length - delay 
h = np.zeros(length, np.float64) 
h[delay:] = np.random.standard_normal(plen) * np.exp( np.linspace(@, -4, plen) ) 
h /= np.sqrt(np.sum(h*h)) 
return h 


def plot_converge(y, u, label=""): 

size = len(u) 

avg_number = 266 

e = np.power(y[:size] - u, 2) 

tmp = e[:int(size/avg_number)*avg_number] 

tmp.shape = -1, avg_number 

avg = np.average( tmp, axis=1 ) 

pl.plot(np.linspace(@, size, len(avg)), 16*np.1log10(avg), linewidth=2.0, label=label) 
def diff db(he, h): 

return 10*np.log10(np.sum( (he-h)*(he-h)) / np.sum(he*he)) 


make_path0 产 生 一 个 长 度 为 length、 最 小 延 时 为 delay 的 指数 衰减 的 波形 。 这 种 波形 和 封 
闭 空间 的 声音 的 传递 函数 比较 近似 ,因此 在 计算 机 上 进行 声音 的 自 适应 滤波 器 算法 模拟 时 经 常 
用 这 种 波形 作为 系统 的 传递 函数 。 

plot_converge0 绘 制 信号 y 和 之 间 的 误差 ,每 ave_number 个 取样 点 就 计算 一 次 两 个 信号 
之 间 误 差 的 平方 的 平均 值 。 我 们 用 它 绘制 未 知 系统 的 输出 y 和 自 适 应 滤波 器 的 输出 u 之 间 的 误 
差 。 观 察 自 适应 滤波 器 是 如 何 收敛 的 ， 以 评价 自 适应 滤波 器 的 收敛 特性 。 

diff db0 同 样 用 来 评价 自 适应 滤波 器 的 收敛 特性 ， 不 过 它 是 直接 计算 未 知 系统 的 传递 函数 
h0 和 自 适 应 滤波 器 的 传递 函数 h 之 间 的 误差 。 下 面 我 们 会 看 到 ,这 两 个 函数 得 到 的 收敛 值 是 相 
同 的 。 


17.3.1 系统 辨识 模拟 
我 们 用 下 面 的 函数 调用 ntms0， 对 图 17-1 所 示 的 系统 识别 进行 模拟 : 


. # system identify.py 
训 < 使 用 NLMS 对 系统 识别 进行 模拟 


# 用 NLMS 对 系统 识别 进行 模拟 ， 未 知 系统 的 传递 函数 为 bg， 使 用 的 参照 信号 为 x 

def sim system identify(nlms_func, x, he@, step_size, noise_scale): 
y = np.convolve(x, he) 
d = y + np.random.standard_normal(len(y)) * noise_scale # 添加 白 噪声 的 外 部 干扰 
h = np.zeros(len(h8)，np.float64) # 自 适应 滤波 器 的 长 度 和 未 知 系统 相同 ， 初 始 值 为 8 
uU = nlms_ func( x, d, h, step_size ) 
return y, u, h 


其 中 : nlms_func 参数 为 NLMS 算法 的 实现 函数 ，x 参数 为 参照 信号 ，h0 参数 为 未 知 系统 
的 传递 函数 ，step_size 参数 为 NLMS 算法 的 更 新 系数 ，noise_scale 参数 为 外 部 干扰 的 系数 ， 它 
决定 外 部 干扰 的 强 弱 ，0 表示 没有 外 部 干扰 。 

在 函数 的 返回 值 中 , y 是 不 包括 外 部 干扰 的 未 知 系统 的 输出 ; u 是 自 适应 滤波 器 的 输出 ; h 
是 自 适 应 滤波 器 最 终 的 系数 。 

我 们 用 下 面 的 函数 创建 未 知 系统 hb0 和 参照 信号 x， 然 后 调用 sim_system_identify0 得 到 结 
果 并 且 绘 图 : 


def system identify test1(): 
he = make_path(32，256) # 随机 产生 一 个 未 知 系统 的 传递 函数 
x = np.random.standard_normal(19669) # 参照 信号 为 白 噪声 
y, u, h = sim system identify(nlms, x, he, 0.5, 80.1) 
print diff_db(he, h) 
pl.figure( figsize=(8, 6) ) 
pl.subplot(211) 
pl.subplots_adjust(hspace=0.4) 
pl.plot(he, c="r") 
pl.plot(h, c="b") 
#p1.title(u" 未 知 系统 和 收敛 后 的 滤波 器 的 系数 比较 ") 
pl.subplot(212) 
plot_converge(y, u) 
#p1.title(u" 自 适应 滤波 器 收敛 特性 ") 
pl1.xlabel(u" 和 迭代 次 数 (取样 点 )") 
pl1.ylabel(u" 收 敛 程度 (dB)") 


图 17-5( 上 ) 显 示 的 是 未 知 系统 (红色 ) 和 自 适 应 滤波 器 ( 蓝 色 ) 的 传递 函数 的 系数 ， 可 以 看 到 ， 
自 适 应 滤波 器 已 经 十 分 接近 未 知 系统 了 。 diff db(h0. hb) 的 输出 为 -25.35dB。 图 17-5( 下 ) 显 示 y 和 
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了 之 间 的 误差 , 可 以 从 中 观察 到 自 适 应 滤波 器 的 收敛 过 程 。 我 们 看 到 ,经 过 约 3000 点 的 计算 之 
后 ， 收 敛 过 程 已 经 饱和 ， 最 终 的 误差 为 -25dB 左右 ， 和 diff db0 的 计算 结果 一 致 。 


站 Er EE Se 
造 人 次 数 《( 职 样 点 ) 


图 17-5 自 适应 滤波 器 收敛 之 后 的 系数 (上 图 ) 和 收敛 速度 (下 图 ) 


从 图 17-5 可 以 看 到 收敛 过 程 的 两 个 重要 特性 : 收敛 时 间 和 收敛 精度 。 参 照 信号 的 特性 、 
外 部 干扰 的 强 弱 和 更 新 系数 都 会 影响 这 两 个 特性 。 下 面 让 我 们 看 看 参照 信号 为 白 噪声 、 外 部 干 
扰 的 能 量 固定 时 ， 更 新 系数 对 它们 影响 ， 结 果 如 图 17-6 所 示 ( 见 文 前 彩 插 )。 由 图 可 知 : 更 新 系 
数 越 小 ， 收 敛 速度 越 慢 ， 但 收敛 精度 越 高 。 


def system identify test2(): 
he = make_path(32，256) # 随机 产生 一 个 未 知 系统 的 传递 函数 
x = np.random.standard_normal(26666) # 参照 信号 为 白 噪声 
pl.figure(figsize=(8,4)) 
for step_size in np.arange(0.1, 1.0, 0.2): 
y, u, h = sim system identify(nlms, x, he, step_size, 80.1) 
plot_converge(y, u, label=u"H=%s" % step_size) 
#pl1.title(u" 更 新 系数 和 收敛 特性 的 关系 ") 
p1.xlabel(u" 和 迭代 次 数 (取样 点 )") 
pl.ylabel(u" 收 敛 程度 (dB)") 
pl.legend() 


图 17-6 更 新 系数 和 收敛 速度 的 关系 


下 面 的 语句 用 来 计算 外 部 干扰 能 量变 化 时 的 收敛 特性 : 


def system identify test3(): 
he = make_path(32，256) # 随机 产生 一 个 未 知 系统 的 传递 函数 
x = np.random.standard_normal(28866) # 参照 信号 为 白 噪声 
pl.figure(figsize=(8,4)) 
for noise_scale in [6.65, 8.1, 89.2, 6.4, 8.8]: 
y, u, h = sim system identify(nlms, x, he, 8.5, noise_scale) 
plot_converge(y, u, label=u"noise=%s" % noise_scale) 
#p1.title(u" 外 部 干扰 和 收敛 特性 的 关系 ") 
pl1.xlabel(u" 和 迭代 次 数 (取样 点 )") 
pl.ylabel(u" 收 敛 程度 (dB)") 
pl.legend() 


从 图 17-7 可 以 看 出 , 当 外 部 干扰 的 振幅 增加 一 倍 、 能 量 增加 6 dB 时 ,收敛 精度 降低 6 dB( 见 
文 前 彩 插 )。 而 由 于 更 新 系数 相同 ， 因 此 收敛 过 程 中 的 收敛 速度 是 一 样 的 。 
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17.3.2 ”信号 均衡 模拟 
对 于 图 17-3 所 示 的 信号 均衡 系统 ， 我 们 用 如 下 的 程序 进行 模拟 : 


; A# signal equalization py 
总 自 适应 信号 均衡 模拟 


def sim signal equalization(nlms_func, x, he, D, step_size, noise_scale): 
d= x[:-D] © 
x = x[D:] 
y = np.convolve(x, he)[:len(x)] @ 
h = np.zeros(2*len(he@)+2*D, np.float64) © 
y += np.random.standard_normal(len(y)) * noise_scale 
uU = nlms_func(y, d, h, step_size) 
return h 
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sim _signal_equation0 的 参数 与 前 面 的 sim_system identify0 类 似 ， 增 加 了 一 个 D 参数 ， 用 
于 表示 延迟 器 的 延 时 。 

在 函数 中 ，@ 首 先 对 输入 信号 进行 延 时 ，@ 然 后 计算 未 知 系统 的 输出 信号 ， 人 @ 并 初始 化 一 
个 足够 长 的 数组 b 作为 自 适应 滤波 器 的 系数 。 这 里 数组 h 的 长 度 为 两 倍 延 时 加 两 倍 未 知 系统 的 
传递 函数 的 长 度 。 

函数 的 返回 值 为 自 适应 滤波 器 收敛 后 的 系数 ， 它 能 够 均衡 h0 对 输入 信号 所 造成 的 影响 。 
我 们 通过 下 面 的 程序 产生 数据 、 调 用 模拟 函数 以 及 绘制 结果 : 


def signal equalization test1(): 
import scipy.signal 
he = make_path(5, 64) 
D = 128 
length = 26666 
data = np.random.standard_normal(length+D) 
h = sim signal equalization(nlms, data, he, D, 8.5, 6.1) 
pl.figure(figsize=(8,4)) 
p1.plot(he，1abel=u" 未 知 系统 ") 
pl.plot(h，1label=u" 自 适应 滤波 器 ") 
pl.plot(np.convolve(he，h)，1label=u" 二 者 卷 积 ") 
#p1.title(u" 信 号 均衡 演示 ") 
pl.legend() 
we, He@ = scipy.signal.freqz(he，worN = 1666) 
w, H = scipy.signal.freqz(h, worN = 1666) 
pl.figure(figsize=(8,4)) 
pl.plot(we, 20*np.log10(np.abs(H@)), w, 26*np.log1e(np.abs(H))) 
丰 p1.title(u" 未 知 系统 和 自 适应 滤波 器 的 振幅 特性 ") 
pl.xlabel(u" 圆 频率 ") 
pl.ylabel(u" 振 幅 (dB)") 


如 果 延 迟 器 的 延 时 D 不够， 那么 会 由 于 因果 律 , 使 得 自 适应 滤波 器 无 法 收敛 。 因此 这 里 我 
们 采用 的 延 时 为 h0 长 度 的 两 倍 。 图 17-8 显示 了 h0、h 以 及 它们 的 卷 积 ( 见 文 前 彩 插 )。 我 们 看 
到 ，h0 和 h 的 卷 积 正好 是 一 个 脉冲 信号 ， 脉 冲 发 生 的 时 刻 正好 等 于 指定 的 延 时 128。 
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图 17-8 ”未知 系统 和 自 适 应 滤波 器 的 级 联 ( 卷 积 ) 近 似 为 标准 延迟 


17-9 显示 了 未 知 系统 的 频率 响应 ( 蓝 色 ) 和 自 适应 滤波 器 的 频率 响应 (绿色 )， 我 们 看 到 二 
者 正好 相反 ， 也 就 是 说 自 适应 滤波 器 均衡 了 未 知 系统 对 信号 的 影响 ( 见 文 前 彩 插 )。 


Tr Tr 
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17-9 未知 系统 和 自 适应 滤波 器 的 频率 响应 正好 相反 


17.3.3 “ 卷 积 逆 运 算 


虽然 卷 积 运算 最 终 能 归结 为 简单 的 加 法 和 乘法 运算 ,然而 卷 积 的 逆 运 算 就 不 是 很 容易 计算 
了 。 我 们 知道 ， 两 个 线性 系统 hl 和 h2 的 级 联 h3 可 以 用 它们 的 脉冲 响应 的 卷 积 计算 求 得 ， 而 
所 谓 卷 积 的 逆 运 算 ， 可 以 想象 为 已 知 h3 和 hl1， 求 一 个 h2 使 它 和 hl 级 联 之 后 正好 等 于 h3。 

根据 卷 积 的 计算 公式 可 知 ， 如 果 hl 的 长 度 为 100，h3 的 长 度 为 199， 那 么 h2 的 长 度 也 为 
100, 因为 h2 的 每 个 系数 都 是 未 知 的 , 于 是 就 有 100 个 未 知 数 , 而 这 100 个 未 知 数 需要 满足 199 
个 线性 方程 : h3 中 的 每 个 系数 都 有 一 个 方程 与 之 对 应 。 由 于 方程 数 大 于 未 知 数 的 个 数 ， 显 然 对 
于 任意 的 hl 和 h3， 并 不 能 保证 有 一 个 h2 使 得 它 和 hl 的 卷 积 正好 等 于 h3。 

既然 不 能 精确 求解 ， 那 么 卷 积 的 逆 运 算 就 变 成 了 一 个 误差 最 小 化 的 优化 问题 。 用 自 适应 滤 
波 器 计算 卷 积 的 逆 运 算 和 计算 信号 均衡 类 似 , 将 白 噪声 x 输入 到 hl 中 得 到 信号 u, 将 x 输入 到 
h3 中 得 到 信号 d， 然 后 使 用 u 作为 参照 信号 ，d 作为 目标 信号 进行 NLMS 计算 ， 最 终 收敛 后 的 
自 适应 滤波 器 的 系数 就 是 h2。 

下 面 的 程序 模拟 了 这 一 过 程 ， 图 17-10 是 程序 的 计算 结果 ( 见 文 前 彩 插 )。 


sk Jnverse_convolve py 
六 一 自 适 应 滤波 器 求 卷 积 逆 运 算 


from nlms_numpy import nlms 
from scipy import signal 
from nlms_common import * 


def inverse_convolve(h1, h3, length): 
x = np.random.standard_normal(16666) 
u = signal.lfilter(h1, 1, x) 
d = signal.lfilter(h3, 1, x) 
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h = np.zeros(length, np.float64) 
nlms(u, d, h, 8.1) 
return h 


hl = np.fromfile("h1.txt", sep="\n") 
h1 /= np.max(h1) 
h3 = np.fromfile("h3.txt", sep="\n") 
h3 /= np.max(h3) 


pl.rc('legend', fontsize=10) 

pl.subplot(411) 

pl.plot(h3, 1abel="h3") 

pl.plot(h1, 1abel="h1") 

pl.legend() 

pl.gca().set yticklabels([]) 

for idx, length in enumerate([128, 256, 512]): 
pl.subplot (412+idx) 
h2 = inverse_convolve(h1, h3, length) 
pl.plot(np.convolve(h1, h2)[:len(h3)], label="h1i*h2(%s)" % length) 
pl.plot(h3, label="h3") 
pl.legend() 
pl.gca().set yticklabels([]) 
pl.gca().set xticklabels([]) 


pl.show() 


图 17-10 卷 积 逆 运 算 结果 演示 


程序 中 的 hl 和 h3 从 文本 文件 中 读 取 而 得 , 它们 是 ANC( 能 动 噪声 控制 ) 系 统 中 实际 测量 的 


脉冲 响应 。 如 果 能 找到 一 个 h2 满足 卷 积 条 件 ， 就 能 够 有 效 地 进行 噪声 控制 。 
程序 计算 出 h2 的 长 度 分 别 为 128、256、512 时 的 结果 ， 可 以 看 出 h2 的 长 度 越 长 ， 结 果 越 
精确 。 


17.4 用 C 语言 加 速 NLMS 运算 


在 用 NumpPy 实现 NLMS 算法 的 程序 中 , 需要 在 Python 级 别 对 输入 信号 的 每 个 取样 值 进行 
循环 ， 显 然 这 样 做 的 运算 效率 并 不 高 。 为 了 让 所 有 的 循环 都 在 C 语言 中 完成 ， 我 们 需要 用 C 
语言 重 写 整个 nlms 函数 。 幸 好 NLMS 算法 并 不 复杂 ， 用 C 语言 编写 也 不 会 增加 多 少 代 码 量 。 
本 节 使 用 上 一 章 介绍 的 方法 ， 在 C 语言 级 别 实现 NLMS 算法 ， 并 且 通 过 Python 调用 它们 。 


17.4.1 用 SWIG 编写 扩展 模块 


用 SWIG 可 以 很 方便 地 为 C 语言 函数 制作 封装 函数 ， 让 它们 能 在 Python 环境 中 调用 。 下 
面 让 我 们 看 看 如 何 使 用 SWIG 制作 计算 NLMS 的 扩展 模块 。 


5 A# cnlms/cnlms.cpp 
守 用 C 语言 实现 的 NLMS 算法 


void cnlms(double x[], int nx, double d[], int nd, 
double h[], int nh, double step, double u[], int nu) 

‘ 

int i, j, count; 

double s, e, power=0; 

double *px; 


// 取 nx、nd、nu 的 最 小 值 
count = nx<nd?nx:nd; 
count = count<nu?count:nu; 


// 开始 的 nh 个 取样 不 更 新 滤波 器 系数 
for(i=6;i<nh;i++) 

power += x[i] * x[i]; 

u[i] = @; 

. 
for(i=nh;i<count;i++) 
{ 

s=0@; 

px = gx[i]; 
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for(j=8;j<nh;j++) 
{ 

Se (pox) hijls 
} 
u[i] = s; 
e= dli] - s; 
px = &x[i]; 
for(j=8;j<nh;j++) 
{ 

h[j] += step * e * (*px--) / power; 
J 


power -= x[i-nh+1] * x[i-nh+1]; 
if(i<count-1) 
power += x[i+1] * x[i+1]; 


} 


这 里 不 对 cnlms0 的 内 容 进 行 详细 分 析 ， 只 看 看 它 的 调用 形式 。 其 中 ，x 是 长 度 为 nx 的 参 
照 信号 ; d 是 长 度 为 nd 的 目标 信号 ; h 是 长 度 为 nh 的 未 知 系统 的 系数 ，step 是 更 新 系数 ; u 用 
来 保存 滤波 器 的 输出 信号 ， 其 长 度 为 nu。 

在 cnlms0 中 ， 我 们 看 不 到 任何 与 NumPy 数组 有 关 的 定义 。 将 NumPy 数组 转换 成 cnlmsO 


可 以 处 理 的 C 语言 数组 的 工作 由 接口 定义 文件 “cnlms.i” 完 


PE mmsenmsi 
的 » 
这 # “cnlms.cpp” 的 SWIG 接口 文件 


Xmodule nlms_swig 
%{ 
#define SWIG_FILE_WITH_INIT 
#include "cnlms.h" 
从 
%include “numpy.i" 
%init %{ 
import_array(); 
%} 


void cnlms( 
double * IN ARRAY1, int DIM1， // x 
double * IN ARRAY1, int DIMI, // d 
double * INPLACE ARRAY1, int DIM1, // h 
double step, 


double * ARGOUT_ARRAY1，int DIM1 // u 
); 
%pythoncode %{ 
def nlms(x, d, h, step): 
n = min(len(x), len(d)) 
return _nlms_swig.cnlms(x, d, h, step, n) 
%} 


在 接口 文件 中 包含 了 定义 各 种 NumPy 类 型 映射 的 “numpy.i” 文 件 。 我 们 使 用 了 三 种 不 同 
的 类 型 映射 对 cnlms0 的 参数 进行 了 转换 : 

e 由 于 参照 信号 x 和 目标 信号 d 在 整个 计算 过 程 中 不 会 发 生变 化 ， 因 此 使 用 (N_ 
ARRAY1, DIM1) 将 它们 定义 为 输入 用 的 数组 参数 。 

。 滤波 器 的 系数 h 会 被 更 新 ， 因 此 使 用 INPLACE _ ARRAY1, DIM1) 将 它 转 换 为 更 新 用 
的 数组 参数 。 

e cnlms0 返 回 滤波 器 的 输出 数组 u， 因 此 用 (ARGOUT_ ARRAY1, DIMI) 将 它 定义 为 返 
回 用 的 数组 。 

这 样 一 来 ，SWIG 生成 的 封装 函数 所 接收 的 参数 如 下 : 


cnlms(x, d, h, step, nu) 


并 且 它 返回 一 个 长 度 为 nu 的 数组 以 表示 滤波 器 的 输出 信号 。 显然 需 要 用 户 指定 nu 是 多 余 
的 , 因为 mu 可 以 由 x 和 4d 的 长 度 决定 。 因此 在 接口 文件 中 我 们 用 %pythoncode 命令 定义 了 一 个 
新 的 函数 nlms0， 这 段 程序 会 被 SWIG 输出 到 自动 生成 的 “cnlms.py” 中 。 

最 后 我 们 制作 了 一 个 “setup.py” 文 件 ， 运 行 “setup.py build_ext --inplace” 即 可 编译 出 用 C 
语言 编写 的 NLMS 扩展 模块 。 

为 了 比较 NumPy 版 本 和 SWIG 版 本 的 NLMS 程序 的 输出 是 否 一 致 , 我 们 制作 了 一 个 简单 
的 脚本 来 进行 测试 : 


A test_nlms.py 


二 验证 NumPy 版 本 和 SWIG 版 本 的 NLMS 程序 的 输出 


import numpy as np 

from nlms_numpy import nlms as numpy_nlms 
from nlms_swig import nlms as swig_nlms 
from nlms_weave import nlms as weave_nlms 
x = np.random.random(166) 

d = np.random.random(166) 

h = np.zeros(16) 

ul = numpy_nlms(x，d，h，6.1) 
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h = np.zeros(16) 
U2 = swig_nlms(x，d，h，6.1) 
h = np.zeros(16) 
U3 = weave_nlms(x，d，h，6.1) 


print np.sum((u1-u2)**2) 
print np.sum((u1-u3)**2) 


测试 程序 的 输出 约 为 3e-31， 因 此 可 以 认为 两 个 程序 的 运行 结果 是 一 致 的 。 请 读者 将 前 面 
介绍 的 几 个 模拟 程序 的 载 入 语句 修改 为 “from nlms_swig import nlms”， 并 测试 程序 的 运行 时 
间 ， 看 看 用 C 语言 编写 的 NLMS 算法 能 带 来 多 少 倍 的 速度 提升 。 


17.4.2 用 Weave 其 入 C++ 程序 


用 SWIG 编写 扩展 模块 比较 麻烦 ,需要 准备 接口 文件 、 编写 “setup.py” 脚 本 。 对 于 NLMS 
这 样 简单 的 程序 显得 有 些 大 材 小 用 。 更 简单 的 办 法 是 使 用 Weave 直接 将 C++ 语言 的 程序 嵌入 到 
Python 程序 中 。 下 面 是 完整 的 源 程序 : 


7 nlms weave.py 
用 Weave 将 NLMS 的 C++ 语言 计算 程序 丛 入 到 Python 中 


import numpy as np 
import scipy.weave as weave 


def nlms(x, d, h, step): 
code = """ 
int i, j, count; 
int nh = Nh[6]; 
double s, e, power=0; 
double *px; 
count = Nu[6]; 
for(i=@;i<nh;i++) 


{ 
power += x(i) * x(i); 
u(i) = @; 

JU 

for(i=nh;i<count;i++) 

{ 
s=0; 
px = &x(i); 
for(j=8;j<nh;j++) 


Ss += (*px--) * h(j); 


u(i) = s; 
e= d(i)-s; 
px = &x(i); 
for(j=8;j<nh;j++) 
h(j) += step * e * (*px--) / power; 
1 
power -= x(i-nh+1) * x(i-nh+1); 
if(i<count-1) 
power += x(i+1) * x(i+1); 


1 


u = np.zeros(min(len(x), len(d))) © 
weave.inline( 


type_converters=weave. converters.blitz, © 
compiler="gcc" 

) 

return u 


@ 创 建 保存 滤波 器 输出 的 数组 ， 其 长 度 取 参 照 信号 x 和 目标 信号 d 中 长 度 较 短 的 那个 。@ 
通过 字符 串 将 当前 名 称 空间 中 的 Python 变量 转换 成 C++ 语言 中 的 变量 。@ 我 们 使 用 blitz 类 处 
理 NumPy 数组 ， 因 此 使 用 weave.converters.blitz 作为 类 型 转换 器 。 

在 嵌入 的 C++ 程序 中 ， 使 用 Nx[0]、Nd[0]、Nh[0]、Nu[0] 获 得 各 个 数组 的 第 0 轴 的 长 度 。 
使 用 圆 括号 访问 数组 的 下 标 ， 例 如 xGD、hG)。 
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单 摆 和 双 摆 模拟 


本 章 首先 介绍 单 摆 和 双 摆 系统 的 公式 推导 , 然后 通过 odeint0 对 其 进行 数值 求解 并 制作 动 
画 演 示 程 序 。 


18.1 单 摆 模拟 


如 图 18-1 所 示 ， 有 一 根 不 可 伸 长 、 质 量 不 计 的 细 棒 ， 上 端 固 
定 ， 下 端 系 一 质点 ， 这 样 的 装置 叫做 单 摆 。 
根据 牛顿 力学 定律 ， 我 们 可 以 列 出 如 下 微分 方程 : 


2 
00 ,gsing =0 
dr 1 


其 中 ，9 为 单 摆 的 摆 角 ，/ 为 单 摆 的 长 度 ，g 为 重力 加 速度 。 

此 微分 方程 的 符号 解 无 法 直接 求 出 ， 因 此 只 能 调用 odeint0 
对 其 求 数值 解 。 

odeint0 的 调用 参数 如 下 : 


18-1 单 摆 装 置 示意 图 


odeint(func, y8, t, ...) 


其 中 ，func 是 Python 的 一 个 函数 对 象 ， 用 来 计算 微分 方程 组 中 每 个 未 知 函数 的 导数 ;y0 
为 微分 方程 组 中 每 个 未 知 函数 的 初始 值 ，t 为 需要 进行 数值 求解 的 时 间 点 。 它 返回 的 是 一 个 二 
维 数组 result， 其 第 0 轴 的 长 度 为 t 的 长 度 ， 第 1 轴 的 长 度 为 变量 的 个 数 ， 因 此 result[:,i] 为 第 i 
个 未 知 函数 的 解 。 

计算 微分 的 func 函数 的 调用 参数 为 func(y, t)， 其 中 y 是 一 个 数组 ， 为 每 个 未 知 函数 在 t 时 
刻 的 值 ， 而 func 的 返回 值 是 每 个 未 知 函数 在 { 时 刻 的 导数 。 

odeint0 要 求 每 个 微分 方程 只 包含 一 阶 导 数 ， 因 此 我 们 需要 对 前 面 的 微分 方程 进行 如 下 变形 : 
d6(D) 

人 


i vn 


4 
sin 8(71) 


下 面 是 计算 单 摆 轨迹 的 程序 ， 摆 角 和 时 间 的 关系 如 图 18-2 所 示 。 


工 -全 


2 本 e 中 38 
加 闻 ( 秒 》 


图 18-2 初始 角度 为 1 弧度 的 单 摆 摆动 角度 和 时 间 的 关系 


A simple_pendulum odeint.py 
污 用 odeint 计算 单 摆 轨 迹 


from math import sin 
import numpy as np 
from scipy.integrate import odeint 


g=9.8 


def pendulum equations(w, t, 1): 
th，Vv = W 
dth = V 
dv = - g/l * sin(th) 
return dth, dv 


if _name__ == 
import pylab as pl 
t = np.arange(0, 10, 0.01) 
track = odeint(pendulum equations, (1.0, 86), t, args=(1.0,)) 
pl.plot(t, track[:, 8]) 
pl.xlabel(u" 时 间 ( 秒 )") 
pl.ylabel(u" 震 度 角度 (弧度 )") 
pl.show() 


main_ 


odeint0 还 有 一 个 args 参数 ， 参 数值 为 一 个 元 组 ， 这 些 值 都 会 作为 额外 的 参数 传递 给 计算 


导数 的 函数 。 程 序 使 用 这 种 方式 将 单 摆 的 长 度 传递 给 pendulum equations0。 
18.1.1 小 角度 时 的 摆动 周期 


高 中 物理 课 上 讲 过 ， 当 最 大 摆动 角度 很 小 时 ， 单 摆 的 摆动 周期 可 以 使 用 如 下 公式 计算 : 
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xx 
- 


这 是 因为 当 9< <1 时 ，sin 9 ~ 9， 这 样 微分 方程 就 变 成 了 : 


此 微分 方程 的 解 是 一 个 简 谐 振动 方程 ， 很 容易 计算 其 摆动 周期 。 下 面 我 们 用 SymPy 对 这 
个 微分 方程 进行 符号 求解 : 


>>> from sympy import symbols, Function, dsolve 

>>> t,g,1 = symbols("t,g,1",real=True) # 分 别 表示 时 间 、 重 力 加 速度 和 长 度 
>>> y = Function("y") # 摆 角 函数 用 y(t) 表示 

>>> dsolve(y(t).diff(t,2) + g/l1*y(t), y(t)) 


2?O=ci oa +C, te 


1 
可 以 看 到 ， 简 谐振 动 方程 的 解 是 由 两 个 频率 相同 的 三 角 函 数 构成 的 ， 区 项 为 x 。 


18.1.2 ”大 角度 时 的 摆动 周期 


但 是 当初 始 摆 角 增 大 时 ， 上 述 近似 处 理会 带 来 无 法 忽视 的 误差 。 下 面 让 我 们 看 看 如 何 用 数 
值 计 算 的 方法 求 出 单 摆 在 任意 初始 摆 角 时 的 摆动 周期 。 


A simple_pendulum period.py 
党 于 数值 法 求 单 摆 摆 动 周期 


要 计算 摆动 周期 , 只 需要 计算 从 最 大 摆 角 到 0 摆 角 所 需 的 时 间 , 摆动 周期 是 此 时 间 的 4 倍 。 
为 了 计算 出 这 个 时 间 值 ， 首 先 需要 定义 一 个 函数 pendulum th0， 计 算 任意 时 刻 的 摆 角 : 


def pendulum th(t, 1, the): 
track = odeint(pendulum equations, (the, 6), [9, t], args=(1,)) 
return track[-1, 6] 


pendulum th0 计 算 长 度 为 1 初始 角度 为 th0 的 单 摆 在 时 刻 t 的 摆 角 。 此 函数 仍然 使 用 odeint0 
进行 微分 方程 组 求解 ， 只 是 我 们 只 需要 计算 时 刻 t 的 摆 角 ， 因 此 传递 给 odeint0 的 时 间 序 列 为 
[0, 1。odeint0 内 部 会 对 时 间 进 行 细 分 ， 以 保证 最 终 的 解 是 正确 的 。 

接 下 来 只 需 找到 第 一 个 使 pendulum th0) 的 值 为 0 的 时 间 即 可 。 这 相当 于 对 pendulum thO 
求解 ， 可 以 使 用 scipy.optimize.fsolve0 对 这 种 非 线 性 方程 进行 求解 : 


def pendulum_period(1，the) : 
te = 2*np.pi*sqrt( 1/g ) /4 
t = fsolve( pendulum th, te@, args = (1, the) ) 
return t*4 


和 odeint0 一 样 , 我们 通过 fsolve0 的 args 参数 将 额外 的 参数 传递 给 pendulum th0。fsolve0 
求解 时 需要 一 个 初始 值 尽量 接近 真实 值 的 解 ， 用 小 角度 单 摆 的 周期 的 1/4 作为 这 个 初始 值 是 一 
个 很 不 错 的 选择 。 下 面 利用 pendulum_ periodO 计 算出 初始 摆动 角度 从 0” 到 90” 的 摆动 周期 ; 


ths = np.arange(86，np.pi/2.6，6.61) 
periods = [pendulum period(1, th) for th in ths] 


为 了 验证 结果 的 正确 性 ， 可 以 从 维基 百科 中 找到 摆动 周期 的 精确 解 : 


T= em 纪 
g 


其 中 的 函数 K 为 第 一 类 完全 椭圆 积分 函数 ， 其 定义 如 下 : 
五 12 dg 
天 (有 = | 一 -一 
四 | MI- 尼 sin20 
可 以 用 scipy.specialellipkO 计 算 此 函数 的 值 : 
periods2 = 4*+sqrt(1.6/g)*ellipk(np.sin(ths/2)**2) # 计算 单 摆 周 期 的 精确 值 


18-3 比较 了 这 两 种 计算 方法 ， 我 们 看 到 它们 的 结果 是 完全 一 致 的 ( 见 文 前 彩 插 )。 


= fsolve 计 算 的 单 摆 珂 期 
一 单 插 周期 稍 兢 信 


LO 2 Dl O00 ds 10 17 1 1.6 
初 赔 举 角 ( 弛 度 ) 


图 18-3 单 摆 的 摆动 周期 和 初始 角度 的 关系 
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18.2 双 摆 模拟 


接 下 来 让 我 们 看 看 如 何 对 双 摆 系统 进行 模拟 。 双 摆 系 统 的 示意 图 如 图 18-4 所 示 。 两 根 长 
度 为 L1 和 工 , 的 无 质量 细 棒 的 顶端 有 质量 分 别 为 mi 和 m 的 两 个 球 , 初始 角度 为 和 和 锡 ， 要 求 
计算 从 此 初始 状态 释放 之 后 两 个 球 的 运动 轨迹 。 


图 18-4 双 捍 装置 示意 图 


18.2.1 公式 推导 
本 节 首 先 介绍 如 何 利用 拉 格 朗 日 力学 获得 双 摆 系 统 的 微分 方程 组 。 


拉 格 朗 日 力学 

拉 格 朗 日 力学 是 分 析 力 学 中 的 一 种 。 它 于 1788 年 由 拉 格 朗 日 创立 ， 拉 格 朗 日 力学 是 对 
经 典 力学 的 一 种 新 的 理论 表述 。 

经 典 力学 最 初 的 表述 形式 由 牛顿 建立 ， 它 着 重 于 分 析 位 移 、 速 度 、 加 速度 、 力 等 矢量 间 
的 关系 ,又 称 为 矢量 力学 。 拉 格 朗 日 引入 了 广义 坐标 的 概念 ， 又 运用 达 朗 贝尔 原理 ， 求 得 与 
牛顿 第 二 定律 等 价 的 拉 格 朗 日 方程 。 不 仅 如 此 ， 拉 格 朗 日 方程 还 具有 更 普遍 的 意义 ,适用 范 
围 更 广泛 。 此 外 ， 选 取 恰 当 的 广义 坐标 ， 可 以 大 大 地 简化 拉 格 朗 日 方程 的 求解 过 程 。 


假设 细 棒 三 连接 的 球体 的 坐标 为 x 和 ， 万 连接 的 球体 的 坐标 为 *, 和 )。， 那 么 x 、y、 
x，、 几 和 两 个 角度 G、0, 之 间 有 如 下 关系 : 


x = sin(0,),y, =-L, cos(0,) 


wa = sin(@,) + 1, sin(0,),», =—L cos(0,) —L, cos(0,) 


根据 拉 格 朗 日 力学 公式 : 


= 
其 中 ，7 为 系统 的 动能 ，7 为 系统 的 势能 ， 可 以 得 到 如 下 公式 : 
[= t+ + ) men -me 


其 中 正 号 的 项 为 两 个 小 球 的 动能 ， 负 号 的 项 为 两 个 小 球 的 势能 。 
将 前 面 的 坐标 和 角度 之 间 的 关系 公式 代入 并 整理 可 得 : 


率 2 本 
= 人 A + +m,LL,0,0, cos(B —0,)+(m, +m,)gL cos(0)+m,gL, cos(0,) 


对 于 变量 @ 的 拉 格 朗 日 方程 : 
dal a 0 


dp0 600 
得 到 > 
LGm+m)h G+mL, cos(0 0) +m,L, sin(@ -0)R +(m +n)gsin 0)]=0 


对 于 变量 6, 的 拉 格 朗 日 方程 : 
dL ol 


df60 060 
得 到 : 


mL [LO +L cos(G -0)0 Lsin(Q 0) +gsin(0,)]=0 
这 一 计算 过 程 可 以 用 SymPy 进行 推导 : 


double_pendulum solver; 
5 办 >_peI 1 py 


这 用 SymPy 推导 双 摆 的 常 微分 方程 


from sympy import * 
from sympy import Derivative as D 


var("x1 x2 y1 y2 11 12 ml m2 th1 th2 dth1 dth2 ddth1 ddth2 t g tmp") 


sublist = [ 

(D(th1(t), t, t), ddth1), 
(D(th1(t), t), dth1), 
(D(Cth2(t), t, t), ddth2), 
(D(th2(t),t), dth2), 
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(th1(t), th1), 
(th2(t), th2) 


] 


x1 = ll*sin(th1(t)) 
y1 = -ll*cos(th1(t)) 
x2 = ll*sin(th1(t)) + 12*sin(th2(t)) 
y2 = -ll*cos(th1i(t)) - 12*cos(th2(t)) 


vx1 = diff(x1, t) 
Vvx2 = diff(x2, t) 
vy1 = diff(y1, t+) 
vy2 = diff(y2, t+) 


# 拉 格 朗 日 力学 公式 
L = m1/2*(VX1**2 + VYy1**2) + m2/2*(VX2**2 + VYy2**2) - ml*g*y1 - m2*g*y2 


# 拉 格 朗 日 方程 
def lagrange_equation(L, Vv): 
dvt = D(v(t), t) 
a= L.subs(dvt, tmp).diff(tmp).subs(tmp, dvt) © 
b = L.subs(dvt, tmp).subs(v(t), v).diff(v).subs(v, v(t)).subs(tmp, dvt) © 


c = a.diff(t) - b 
c= c.subs(sublist) 

c = trigsimp(simplify(c)) 

c = collect(c, [th1,th2,dth1,dth2,ddth1,ddth2]) 
return < 


eql = lagrange_equation(L, th1) 
eq2 = lagrange_equation(L, th2) 
print eql 
print eq2 


执行 此 程序 之 后 ，eql 对 应 于 & 的 拉 格 朗 日 方程 ，eq2 对 应 于 @, 的 拉 格 朗 日 方程 。 
由 于 SymPy 只 能 对 符号 变量 求 导数 ， 即 只 能 计算 DCL, Db， 而 不 能 计算 DG v(D)。@ 因 此 


在 求 偏 导数 之 前 ， 将 偏 导数 变量 置换 为 一 个 tmp 变量 ,然后 对 tmp 变量 求 导 数 ， 例 如 下 面 的 程 
序 对 DCv(D,b 求 偏 导 数 ， 即 计算 eaL/ev : 


L.subs(D(v(t), t), tmp).diff(tmp).subs(tmp, D(v(t), t)) 


@ 而 在 计算 aL/6v 时 , 需要 将 v(t) 蔡 换 为 v 之 后 再 进行 微分 计算 。 由 于 将 v0) 蔡 换 为 v 的 同 


时 ， 会 将 D(v(), 中 的 也 进行 替换 ， 这 不 是 我 们 希望 的 结果 ， 因 此 先 将 DC(v(D, 替换 为 mp， 
微分 计算 完毕 之 后 再 蔡 换 回去 : 


L.subs(D(v(t), t), tmp).subs(v(t), v).diff(v).subs(v, v(t)).subs(tmp, D(v(t), t+)) 


最 后 得 到 eql 和 eq2 的 值 为 : 


>>> eql 

ddth1*(m1*11**2 + m2*]1**2) 十 

ddth2*(11*12*m2*cos(th1)*cos(th2) + 11*12*m2*sin(th1)*sin(th2)) + 
dth2**2*(11*12*m2*cos(th2)*sin(th1) - 11*12*m2*cos(th1)*sin(th2)) + 
g*11*m1*sin(th1) + g*11*m2*sin(th1) 

>>> eq2 

ddth1*(11*12*m2*cos(th1)*cos(th2) + 11*12*m2*sin(th1)*sin(th2)) + 
dth1**2*(11*12*m2*cos(th1)*sin(th2) - 11*12*m2*cos(th2)*sin(th1)) + 
g*12*m2*sin(th2) + ddth2*m2*12**2 


结果 看 上 去 挺 复杂 ， 其 实 只 要 运用 如 下 的 三 角 公 式 ， 就 和 前 面 的 结果 一 致 了 ; 
sin(x+y)=sinxcosy+cosxsiny 
Cos(x+y)=cosxcosy—sinxsiny 
sin(x—»)=sinxcosy—cosxsiny 
Cos(x—y)=cosxcosy+sinxsiny 
18.2.2 ”微分 方程 的 数值 解 
接 下 来 要 做 的 事情 就 是 对 如 下 的 微分 方程 组 求 数值 解 : 
(mi +m,)L, B+m,L, cos(0, —0,)6, +m,L, sin(g —0,)0,” +(m, +m,)g sin(0,)=0 
L, +L cos(0, -0,)6 —L, sin(@, -0,)0, +gsin(0,)=0 


由 于 方程 中 包含 二 阶 导数 ， 因 此 无 法 直接 使 用 odeint0 进 行 数值 求解 ， 我 们 很 容易 将 其 改 
写 为 4 个 一 阶 微分 方程 组 ，4 个 未 知 变量 为 @ 、@ 、w 、 内 ， 其 中 ，w 、 为 两 个 细 村 转动 的 


角速度 。 
A=n 
人 =v, 
(Cm +m )L +m,L, cos(O, —0,)v, +m,L, sin( —0,)0,” +(m, +m,)g sin(0,)=0 


L, V+Li cos(O, —0,)% -Li sin(b -0,)0,” +gsin(0,)=0 
下 面 的 程序 对 此 微分 方程 组 进行 数值 求解 。 


a double pendulum odeint.py 
用 odeint 求解 双 摆 系统 
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g =9.8 
class DoublePendulum(object): 
def _init_(self, mi, m2, 11, 12): 
self.m1, self.m2, self.11, self.12 = ml, m2, 11, 12 
self.init_status = np.array([6.6,6.9,8.9,9.9]) 


def equations(self，w，t): © 


微分 方程 公式 


ml, m2, 11, 12 = self.m1，self.m2，self.11，self.12 
th1i, th2, v1, v2 = W 


dthl = v1 
dth2 = v2 
#eq of th1 


a = 11*(ml+m2) # dv1 parameter 
b = m2*12*cos(th1-th2) # dv2 paramter 
c = m2*12*sin(th1-th2)*dth2*dth2 + (ml+m2)*g*sin(th1) 


#eq of th2 

d = ll*cos(th1i-th2) # dv1 parameter 

e = 12 # dv2 parameter 

f = -ll1*sin(th1-th2)*dth1*dth1 + g*sin(th2) 


dv1，dv2 = np.linalg.solve([[a,b],[d,e]], [-c,-f]) @ 
return np.array([dth1，dth2，dv1，dv2]) 


@DoublePendulum 类 的 equations0 用 于 计算 各 个 未 知 函 数 的 导数 , 输入 参数 w 数组 中 的 变 
量 依次 为 也 1、th2、vl 和 2， 它 们 分 别 表示 上 球 角度 、 下 球 角 度 、 上 球 角速度 和 下 球 角速度 。 

返回 值 为 每 个 变量 的 导数 dthl、dth2、dvl 和 dv2， 它 们 分 别 表示 上 球 角 速度 、 下 球 角 速 
度 、 上 球 角 加 速度 和 下 球 角 加 速度 。 其 中 ，dthl 和 dth2 很 容易 计算 ， 它 们 直接 等 于 传 入 的 角 速 
度 变量 。 

为 了 计算 dvl 和 dv2， 需 要 将 微分 方程 组 变形 为 如 下 格式 : 


六 = 信 =.. 
由 于 两 个 微分 方程 对 于 包 和 羽 来 说 是 两 个 如 下 形式 的 一 次 方程 : 
avi+bv,+c=0,d% +evw,+f =0 
因此 可 以 求 出 其 中 的 系数 a、b、c、d、e、f，@ 然 后 调用 linalg.solve0 解 出 名 和 VY, 。 


def double pendulum odeint(pendulum, ts, te, tstep): 


对 双 摆 系统 的 微分 方程 组 进行 数值 求解 ， 返 回 两 个 小 球 的 X-Y 坐标 


t = np.arange(ts, te, tstep) 

track = odeint(pendulum.equations, pendulum.init status, +t) © 
th1_array, th2 array = track[:,8], track[:, 1] 
11, 12 = pendulum.11, pendulum.12 

x1 = ll*np.sin(th1_array) 

y1 = -lil*np.cos(th1 array) 

x2 = xl + l2*np.sin(th2_array) 

y2 = y1 - 12*np.cos(th2_array) 

# 将 最 后 的 状态 赋 给 pendulum 

pendulum.init_status = track[-1,:].copy() @ 
return xl1，y1，x2，y2 © 


在 double_pendulum_odeint0 中 ， 合 调用 odeint0 对 双 摆 的 方程 组 求 数值 解 。@ 将 odeint0 得 
到 的 最 终 的 小 球状 态 保存 到 pendulum init_status 中 ,作为 下 一 次 调用 odeint0 的 初始 值 ， 因 此 多 
次 调用 double_pendulum _odeint0 可 以 生成 连续 的 运动 轨迹 。@ 函 数 返 回 4 个 数组 , 分 别 是 两 个 
小 球 的 X-Y 轴 的 坐标 。 

最 后 是 主 程序 部 分 ， 我 们 使 用 小 角度 和 大 角度 的 初始 值 分 别 计算 双 摆 的 摆动 轨迹 。 小 初始 
角度 时 小 球 的 运动 轨迹 如 图 18-5 所 示 ( 见 文 前 彩 插 )。 大 初始 角度 时 小 球 的 运动 轨迹 如 图 18-6 所 
示 ( 见 封 三 彩 播 )。 可 以 看 出 ， 当 初始 角度 很 大 时 ， 摆 动 出 现 混 沌 现象 。 


-2 -1 a 1 2 


图 18-5 ”小 初始 角度 时 双 摆 的 摆动 轨迹 


图 18-6 ”大 初始 角度 时 双 摆 的 摆动 轨迹 呈现 混沌 现象 
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18.2.3 ”动画 演示 


有 了 计算 双 摆 运 动 轨 迹 的 程序 之 后 , 我 们 很 容易 使 用 前 面 介绍 过 的 动画 技术 直观 地 演示 双 
摆 系 统 的 运算 结果 。 制 作 动画 可 以 有 多 种 选择 : 

e 使 用 VPython 制作 三 维 动画 。 

e 使 用 Tkinter 或 wxPython 直接 在 界面 上 绘制 动画 。 

e 使 用 Enable、Chaco 或 matplotlib 制作 动画 。 

本 书 提供 使 用 matplotib 和 Enable 制作 的 双 摆动 画 演示 程序 ， 它 们 调用 上 一 节 介绍 的 
double_ pendulum_ odeint0 来 计算 双 摆 的 运动 轨迹 。 


double pendulum pylab anipy, double pendulum enable anipy 
二 用 matplotib 和 Enable 制作 双 摆 的 动画 演示 


使 用 Enable 制作 的 动画 演示 程序 的 界面 截图 如 图 18-7 所 示 。 在 此 界面 中 ， 用 户 可 以 修改 
双 摆 的 质量 和 长 度 ， 并 且 可 以 在 动画 框 中 按 住 并 拖 动 鼠标 ， 修 改 双 摆 的 初始 角度 。 


HN} $0 = 5 


os 


bl 人 一 asf 
0 “hr to 


18-7 用 Enable 制作 的 双 摆动 画 演示 程序 


分 形 几 何 


自然 界 的 很 多 事物 ， 例 如 树木 、 云 彩 、 山 脉 、 闪 电 、 雪 花 以 及 海岸 线 等 ， 都 呈现 出 传统 几 
何 学 难以 描述 的 形状 。 这 些 形状 都 有 如 下 特性 : 

。 具有 十 分 精细 的 不 规则 的 结构 。 

。 整体 与 局 部 相似 ， 例 如 一 根 树 权 的 形状 和 一 棵 树 很 像 。 

分 形 几何 学 就 是 用 来 研究 这 样 一 类 几何 形状 的 数学 ， 借 助 计算 机 的 高 速 计算 和 图 像 显 示 ， 
我 们 可 以 更 深入 、 更 直观 地 研究 分 形 几何 。 作 为 本 书 的 最 后 一 章 ， 让 我 们 看 看 如 何 使 用 Python 
绘制 一 些 经 典 的 分 形 图 形 。 


19.1 Mandelbrot 集合 


Mandelbrot( 曼 德 布 洛 特 ) 集 合 是 在 复 平面 上 构成 分 形 图 案 的 点 的 集合 ， 它 可 以 用 下 面 的 复 
二 次 多 项 式 定义 : 


f=2 +c 


其 中 ， 复 数 函数 大 (G) 的 自 变量 为 =。e 是 一 个 复数 参数 ， 对 于 每 一 个 ce:， 从 ==0 开始 对 函数 
正中 进行 迭代 。 序列 (0,f(0),f(JA0)),(J(J(0))),… 的 值 要 么 延伸 到 无 限 大 ， 要么 只 停留 在 有 限 
半径 的 圆 盘 内 。Mandelbrot 集合 就 是 使 以 上 序列 不 发 散 的 所 有 参数 c 的 集合 。 

从 数学 上 来 讲 , Mandelbrot 集合 是 一 个 复数 的 集合 。 一 个 给 定 的 复数 c 要 么 属于 Mandelbrot 
集合 ， 要 么 不 是 。 但 是 用 程序 绘制 Mandelbrot 集合 时 不 能 进行 无 限 次 欠 代 ， 最 简单 的 方法 是 使 
用 逃逸 时 间 ( 和 迭代 次 数 ) 进 行 绘制 ， 具 体 算 法 如 下 : 

。 判断 每 次 调用 函数 大 (2) 后 得 到 的 结果 是 否 在 半径 RR 之 内 ， 即 复数 的 模 是 否 小 于 R。 

。 记录 下 迭代 结果 的 模 值 大 于 了 时 的 欠 代 次 数 ， 也 称 为 逃逸 时 间 。 

。 和 迭代 最 多 进行 人 次 。 

。 不同 迭代 次 数 的 点 使 用 不 同 的 颜色 来 绘制 。 

下 面 是 绘制 Mandelbrot 集合 的 完整 程序 ， 绘 制 的 图 案 如 图 19-1 所 示 ( 见 封 三 彩 插 )。 


有 # mandelbrot_python.py 
全 于 绘制 Mandelbrot 集合 
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import numpy as np 
import pylab as pl 
import time 

from matplotlib import cm 


def iter point(c): © 
环宇 民 
for i in xrange(1，166): # 最 多 迭代 188 次 
if abs(z)>2: break # 半径 大 于 2 就 认为 逃逸 
Z = Z#Z+C 


return i # 返回 迭代 次 数 


def draw mandelbrot(cx, cy, d): © 


绘制 点 (cx，cy) 附 近 在 正 负 d 范围 之 内 的 Mandelbrot 


x8, x1, y@, y1 = cx-d, cx+d, cy-d, cy+d 
y, x = np.ogrid[ye:y1:266j，x6:x1:266j] 
c=x+y*1j®© 


start = time.clock() 

mandelbrot = np.frompyfunc(iter point,1,1)(c).astype(np.float) @ 
print "time=",time.clock() - start 

pl.imshow(mandelbrot, cmap=cm.Blues_r, extent=[x8,x1,y8,y1]) © 
pl.gca().set axis off() 


XxX,y = 0.27322626, @.595153338 


pl.subplot(231) 
draw_mandelbrot(-8.5,8,1.5) 
for i in range(2,7): 

pl.subplot(238+i) 

draw_mandelbrot(x, y, 0.2**(i-1)) 
pl.subplots_adjust(8.62, 8, 6.98, 1, 8.02, 6) 
pl.show() 


19-1 Mandelbrot 集合 ， 以 5 倍 倍率 放大 点 (0.273. 0.595) 附 近 


@iter point0 计 算 点 c 的 逃逸 时 间 , 逃逸 半径 R 为 2.0, 最 大 和 迭代 次 数 为 100.@Bdraw mandelbrot0 
绘制 以 点 (cx, cy) 为 中 心 ， 边 长 为 2*d 的 正方 形 区 域内 的 Mandelbrot 集合 的 图 案 。 

目 计 算 指定 范围 内 的 参数 c， 它 是 一 个 二 维 的 复数 数组 ， 形 状 为 (200, 200)。 这 里 用 ogrid 
对 象 快速 产生 实 部 和 虑 部 网 格 x 和 y， 然 后 通过 广播 运算 得 到 数组 c。 

@ 接 下 来 通过 frompyfunc0 将 iter_point0 转 换 为 ufunc 函数 , 这 样 便 可 以 自动 对 c 中 的 每 个 
元 素 调 用 iter point0 进 行 运算 。 由 于 结果 数组 的 元 素 类 型 为 object， 因 此 还 需要 调用 astype0 将 
其 元 素 类 型 转换 为 浮 点 数 类 型 。@ 最 后 调用 matplotlib 的 imshow0 将 结果 数组 绘制 成 图 ， 通 过 
cmap 参数 指定 颜色 映射 表 。 

使 用 Python 绘制 Mandelbrot 集合 ， 最 大 的 问题 就 是 运算 速度 太 慢 ， 下 面 是 图 19-1 中 每 幅 
图 的 计算 时 间 : 


time= 9.88162629668 
time= 1.53712748468 
time= 1.71562166191 
time= 1.8691174437 
time= 3.93812691278 


因为 每 个 点 的 逃逸 时 间 均 不 相同 ， 所 以 计算 每 幅 图 所 需 的 时 间 也 不 相同 。 
19.1.1 使 用 NumPy 加 速 计算 


借助 NumPy 的 数组 运算 可 以 提高 计算 速度 。 前 面 介 绍 的 计算 是 在 外 层 循环 中 对 复 平面 上 
的 每 个 点 进行 计算 ， 在 内 部 循环 中 计算 每 个 点 的 逃逸 时 间 。 如 果 要 用 数组 运算 来 加 速 计算 ， 就 
需要 将 这 两 个 循环 的 顺序 颠倒 。 下 面 的 程序 演示 了 这 一 算法 : 


A# mandelbrot_ numpy.py 
六 用 Numpy 加 速 Mandelbrot 集 合计 算 


import numpy as np 

import pylab as pl 

import time 

from matplotlib import cm 


def draw_ mandelbrot(cx, cy, d, N=280): 


绘制 点 (cx，cy) 附 近 在 正 负 d 范围 之 内 的 Mandelbrot 


global mandelbrot 


x0, x1, y9, yl1 = cx-d, cx+d, cy-d, cy+d 
y, x = np.ogrid[y@:y1:N*1j, x@:x1:N*1j] 
em Xx 
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# 创建 X、Y 轴 的 坐标 数组 
ix, iy = np.mgrid[@:N,0:N] 


# 创建 保存 mandelbrot 图 的 二 维 数组 ， 默 认 值 为 最 大 迭代 次 数 
mandelbrot = np.ones(c.shape，dtype=np.int)*166 


# 将 数组 都 变 成 一 维 的 
ix.shape = -1 
iy.shape = -1 
c.shape = -1 


z = c.copy() # 从 c 开始 迭代 ， 因 此 开始 的 迭代 次 数 为 1 
start = time.clock() 


for i in xrange(1,166): 
# 进行 一 次 迭代 
z*=z0O 
z+=c 
# 找到 所 有 结果 逃逸 了 的 点 
tmp = np.abs(z) > 2.6 @ 
# 将 这 些 逃 逸 点 的 选 代 次 数 赋值 给 mandelbrot 图 
mandelbrot[ix[tmp], iy[tmp]] = i 


# 找到 所 有 没有 逃逸 的 点 

np.logical not(tmp, tmp) © 

# 更 新 ix、iy、c、z， 只 包含 没有 逃逸 的 点 
ix,iy,c,z = ix[tmp], iy[tmp], c[tmp],z[tmp] 
if len(z) == @: break 


print "time=",time.clock() - start 
pl.imshow(mandelbrot, cmap=cm.Blues_r, extent=[x8,x1,y8,y1]) 
pl.gca().set axis_off() 


XxX,y = 8.27322626, 8@.595153338 


pl.subplot(231) 
draw_mandelbrot(-0.5,8,1.5) 
for i in range(2,7): 

pl.subplot(236+i) 

draw_mandelbrot(x, y, 0.2**(i-1)) 
pl.subplots_adjust(8.02, 0, 9.98, 1, 9.02, 0) 
pl.show() 


为 了 减少 计算 次 数 ， 程 序 中 每 次 迭代 之 后 ， 都 将 已 经 逃逸 的 点 剔除 出 去 ， 这 样 就 需要 保存 
每 个 点 的 下 标 。 程 序 中 用 两 个 数组 和 i 保存 没有 逃逸 的 点 的 下 标 ， 因 为 有 额外 的 数组 保存 
下 标 ， 因 此 数组 z 和 e 不 需要 是 二 维 的 。 


上 @ 进 行 函数 的 欠 代 计算 。 使 用 “*”、“:+=” 这 样 的 运算 符 能 够 让 NumPy 不 分 配额 外 的 
空间 ， 直 接 在 数组 z 上 进行 运算 。 

四 计算 逃逸 点 ， 此 处 的 逃逸 半径 为 2。tmp 是 逃逸 点 在 z 中 的 下 标 ， 由 于 z、 这 、iy 等 数组 
始终 是 同时 更 新 的 ， 因 此 (ix[tmp], iyftmp]) 就 是 逃逸 点 在 图 像 中 的 下 标 。 将 数组 mandelbrot 中 逃 
逸 点 的 值 设 置 为 当前 的 迭代 次 数 。 

目 最 后 通过 对 tmp 中 的 每 个 元 素 取 逻 辑 反 ， 更 新 所 有 没有 逃逸 的 点 对 应 的 这 、i、c、z。 

此 程序 的 计算 时 间 如 下 : 


time= 9.186676576668 
time= 0.327086365334 
time= 9.372756934636 
time= 8.419674464771 
time= 8.681648289658 
time= 0.878626752841 


19.1.2 ”使 用 Weave 加 速 计算 


计算 速度 慢 的 最 大 原因 在 于 iter point0 中 的 循环 运算 。 如 果 将 此 函数 用 C 语言 重 写 , 将 能 
显著 提高 计算 速度 。 下 面 使 用 SciPy 的 Weave 模块 ， 将 用 C++ 重 写 的 iter_point0 嵌 入 到 Python 
程序 中 : 


a mandelbrot_weave.py 
用 Weave 加 速 Mandelbrot 集合 的 计算 


def weave_iter point(c): 

Code = """ 

std: :complex<double> zj 

ts 

了 

for(i=1;i<166;i++) 

于 
if(std::abs(z) > 2) break; 
Z = Z*2Z+C; 

中 


return_val=i; 


f = weave.inline(code, ["c"], compiler="gcc") 
return f 


下 面 是 使 用 weave_iter_point0 计 算 Mandelbrot 集合 的 时 间 : 
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time= 0.285266982256 
time= 9.271436628118 
time= 0.293769188161 
time= 9.398515188383 
time= 9.411168179196 


19.1.3 连续 的 逃逸 时 间 


修改 逃逸 半径 R 和 最 大 迭代 次 数 N， 可 以 绘制 出 不 同 效果 的 Mandelbrot 集合 图 案 。 但 是 
使 用 前 面 所 讲 方法 计算 出 的 逃逸 时 间 大 于 逃逸 半径 时 的 迭代 次 数 ， 因 此 输出 的 图 像 最 多 只 有 
种 不 同 的 颜色 值 ， 有 很 强 的 梯度 感 。 为 了 在 不 同 的 梯度 之 间 进 行 渐变 处 理 ， 可 是 使 用 下 面 的 公 
式 对 逃逸 时 间 进 行 计 算 : 
n—log, log, |2, | 


马 是 迭代 n 次 之 后 的 结果 ,通过 在 逃逸 时 间 的 计算 中 引入 迭代 结果 的 模 值 ， 结 果 将 不 再 是 
整数 ， 而 是 平滑 渐变 的 。 下 面 是 计算 逃逸 时 间 的 程序 : 


本 A mandelbrot_smooth_python.py 
密使 用 逃逸 时 间 平滑 Mandelbrot 集合 图 案 


def smooth iter point(c): 
z=c 
for i in xrange(1, iter_num): 
if abs(z)>escape_radius: break 
zs ZHZIC 
absz = abs(z) 
if absz > 2.6: 
mu = i - log(log(absz,2),2) 
else: 
mu = 主 


return mu # 返回 正规 化 的 迭代 次 数 


如 果 逃 逸 半径 设置 得 很 小 ， 例 如 2.0， 那 么 有 可 能 结果 不 够 平滑 。 这 时 可 以 在 迭代 循环 之 
后 添加 几 次 迭代 ， 以 保证 z 的 模 值 足够 大 。 例 如 在 迭代 循环 之 后 添加 如 下 代码 : 


Z = Z#Z+C 
Z = Z*#Z+C 
i += 2 


19-2 是 逃逸 半径 为 10、 最 大 迭代 次 数 为 20 的 结果 ( 见 封 三 彩 插 )。 


图 19-2 平滑 处 理 后 的 Mandelbrot 集合 : 逃逸 半径 =10， 最 大 迁 代 次 数 =20 


© http://linas.org/art-gallery/escape/ray.html 
逃逸 时 间 公式 的 详细 推导 


19.1.4 ”Mandelbrot 演示 程序 


为 了 实时 计算 Mandelbrot 集合 的 图 像 , 我 们 需要 更 快 的 运算 速度 , 可 以 将 所 有 的 循环 计算 
逃逸 时 间 的 部 分 都 使 用 C 语言 编写 ， 然 后 用 Weave 模块 将 其 嵌入 到 Python 程序 中 。 下 面 是 用 
Chaco 制作 的 实时 绘制 Mandelbrot 集合 的 演示 程序 ， 界 面 截 图 如 图 19-3 所 示 ( 见 封 三 彩 插 )。 


大 mandelbrot_weave_demo.py 
六 实时 绘制 Mandelbrot 集合 的 演示 程序 


19-3 ”实时 绘制 Mandelbrot 集合 的 演示 程序 


在 界面 中 , 用 户 可 以 通过 鼠标 滚 轴 对 Mandelbrot 图 像 进行 缩放 , 使 用 鼠标 左 键 拖 动 图 像 的 
显示 范围 ， 并 且 可 以 用 图 像 上 方 的 工具 条 修改 图 像 的 颜色 映射 表 。 

下 面 是 计算 Mandelbrot 集合 图 像 的 函数 。 参 数 cx 和 cy 是 复 平面 上 计算 范围 的 中 心 点 ， 参 
数 d 是 中 心 点 到 计算 边界 的 实 轴 上 的 长 度 ， 参 数 arr 是 保存 计算 结果 的 二 维 数组 : 


def weave_mandelbrot(cx, cy, d, arr): 
cx = float(cx) 
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和 迭代 函数 系统 是 一 种 创建 分 形 图 案 的 简单 算法 ， 它 所 创建 的 分 形 图 案 永 远 是 绝对 自 相 似 
的 。 下 面 我 们 以 绘制 某 种 茧 类 植物 叶子 的 图 案 为 例 ， 介 绍 迭 代 函 数 系统 算法 以 及 如 何 用 Python 


来 实现 。 


cy = float(cy) 
d = float(d) 
code = """ 
double x, y; 
int h = Narr[6]; 
int w = Narr[1]; 
double dx = 2*d / (double)w; 
y = cy-d*(double)h/w; 
for(int i=8;i<h;i++) 
{ 
x = Cx-d; 
for(int j=0;j<w;j++) 
int k; 
double zx, zy; 
zx = xi Zy =y; 
for(k=1;k<188;k++) 
{ 
double tx, ty; 
if(zx*zx + ZzZy*zy > 4) break; 
tx = ZX*Zx = 2y*Zy + xX; 
ty = 2*zx*zy + y; 
zx = tx; 
zy = ty; 
} 
double absz = sqrt(zx*zx + Zzy*zy); 
if(absz>2.6) arr(i,j) = k - log(log(absz)/log(2))/10g(2); 
else arr(i,j) = k; 
X += dx; 
Ji 
y += dx; 
出 
weave.inline(code, ["cx", "cy", "d", "arr"], compiler="gcc", 
type_converters=converters.blitz) 


19.2 ”和 代 函数 系统 IFS) 


用 下 面 4 个 线性 函数 对 二 维 平 面 上 的 坐标 进行 线性 变换 : 


本 
x(n+1)= @ 
y(n+1) = 9.16 * y(n) 


x(n+1) = 0.2 * x(n) - 6.26 * y(n) 
y(n+1) = 9.23 * x(n) + 9.22 * y(n) + 1.6 


x(n+1) = -80.15 * x(n) + 9.28 * y(n) 
y(n+1) = 9.26 * x(n) + 9.24 * y(n) + 9.44 


x(n+1) = 8.85 * x(n) + 9.64 * y(n) 
y(n+1) = -0.04 * x(n) + 9.85 * y(n) + 1.6 


所 谓 迭 代 函 数 系统 ， 是 指 将 函数 的 输出 再 次 当做 输入 进行 迭代 计算 ， 即 用 上 面 公式 将 坐标 
x(n)、y(n) 变 换 成 坐标 x(n+1)、y(n+1)。 问 题 是 有 4 个 迭代 函数 ， 迭 代 时 选择 哪个 函数 进行 计算 
呢 ? 我 们 为 每 个 函数 指定 一 个 概率 值 ， 它 们 依次 为 1%、7%、7%、85%。 通 过 每 个 函数 的 概率 
随机 选择 一 个 函数 进行 迭代 。 上 面 的 例子 中 ， 第 4 个 函数 被 选择 进行 迭代 的 概率 最 高 。 

最 后 ， 我 们 从 坐标 原点 (0.0) 开 始 和 迭代 ， 绘 制 每 次 欠 代 得 到 的 坐标 点 ， 进 而 得 到 迭代 函数 系 
统 的 分 形 图 案 。 下 面 的 程序 演示 了 这 一 计算 过 程 : 


a IFS fem.py 


使 用 迭代 函数 系统 绘制 叶子 的 分 形 图 案 


import numpy as np 
import matplotlib.pyplot as pl 
import time 


# 蕨 类 植物 叶子 的 迭代 函数 及 其 概率 值 
eql = np.array([[8,6,6],[86,86.16,6]]) 
pl = 9.61 


eq2 = np.array([[8.2,-6.26,6],[6.23,8.22,1.6]]) 
p2 = 6.67 


eq3 = np.array([[-8.15，8.28，6],[6.26,9.24,6.44]]) 
p3 = 86.67 


eq4 = np.array([[6.85，6.64，6],[-8.64，6.85，1.6]]) 
p4 = 6.85 
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def ifs(p, eq, init, n): 
进行 函数 先 代 
p: 每 个 函数 的 选择 概率 列表 
eq: 迭代 函数 列表 
init: 和 迭代 初始 点 
n: 和 迭代 次 数 


返回 值 : 每 次 欠 代 所 得 的 X 坐标 数组 ，Y 坐标 数组 ， 计 算 所 用 的 函数 下 标 


# 迁 代 向 量 的 初始 化 
pos = np.ones(3，dtype=np.float) © 
pos[:2] = init 


# 通过 函数 概率 ， 计 算 函 数 的 选择 序列 

p = np.add.accumulate(p) © 

rands = np.random.rand(n) 

select = np.ones(n, dtype=np.int)*(n-1) 

for i, x in enumerate(p[::-1]): 
select[rands<x] = len(p)-i-1 


# 结果 的 初始 化 
result = np.zeros((n,2)，dtype=np.float) 
c = np.zeros(n，dtype=np.float) 


for i in xrange(n): 
eqidx = select[i] # 所 选 的 函数 下 标 
tmp = np.dot(eq[eqidx]，pos) # 进行 欠 代 
pos[:2] = tmp # 更 新 迭代 向 量 


# 保存 结果 
result[i] = tmp 
c[i] = eqidx 


return result[:,8], result[:, 1], c¢ 


start = time.clock() 

x, y, 5 = ifs([p1,p2,p3,p4], [eq1,eq2,eq3,eq4], [6,0], 106660) 
print time.clock() - start 

pl.figure(figsize=(6,6)) 

pl.subplot(121) 

pl.scatter(x, y, s=1, c="g", marker="s", linewidths=0) © 
pl.axis("equal") 

pl.axis("off") 

pl.subplot(122) 


pl.scatter(Xx，y，s=1，c = c，marker="s"，1linewidths=6) @ 
pl.axis("equal") 

pl.axis("off") 

pl.subplots_adjust(left=0,right=1,bottom=0, top=1,wspace=8, hspace=08) 
pl.gcf().patch.set facecolor("white") 

pl.show() 


f0 是 进行 函数 迭代 的 主 函数 。@ 我 们 希望 通过 矩阵 乘法 dot0 计 算 坐 标 变换 的 结果 ， 因 此 
需要 将 初始 迭代 坐标 扩展 为 三 维 齐 次 坐标 。 这 样 一 来 ， 与 迭代 系数 进行 矩阵 乘积 运算 的 向 量 就 
变 成 了 (x(n), y(n), 1.0)。 

@ 为 了 减少 计算 时 间 ， 我 们 不 在 迭代 循环 中 计算 选择 迭代 方程 的 随机 数 ， 而 是 事先 通过 每 
个 和 迭代 方程 的 概率 ， 计 算出 选择 数组 select。 注 意 这 里 使 用 accumulate0 先 将 概率 累加 ， 然 后 产 
生 一 组 0 到 1 之 间 的 随机 数 ， 通 过 判断 随机 数 所 在 的 区 间 来 选择 不 同 的 方程 下 标 。 也 可 以 使 用 
Scipy 的 stats 模块 中 的 离散 随机 变量 来 产生 这 个 随机 下 标 数组 。 

四 最 后 通过 scatter0 将 得 到 的 坐标 点 绘制 成 散 列 图 。 其 中 : s 参数 是 每 个 散 列 点 的 大 小 ， 
为 我 们 要 绘制 10 万 个 点 ， 为 了 提高 绘图 速度 ， 我 们 选择 点 的 大 小 为 1 个 像素 ; c 参数 是 点 的 颜 
色 ， 这 里 选择 绿色 ; marker 参数 是 点 的 形状 ，"s" 表 示 正 方形 ,方形 的 绘制 是 最 快 的 ， linewidths 
参数 是 点 的 边框 宽度 ，0 表示 没有 边框。 

@ 此 外 ，* 参数 还 可 以 传 入 一 个 数组 ， 作 为 每 个 点 的 颜色 值 。 我 们 将 计算 坐标 的 公式 下 标 
传 入 ， 这 样 可 以 直观 地 看 出 点 是 由 哪个 公式 迭代 产生 的 。 

19-4 是 程序 的 输出 结果 ( 见 封 三 彩 插 )。 观 察 右 图 中 4 种 颜色 的 分 布 , 可 以 发 现 概率 为 1% 
的 迭代 方程 所 计算 的 是 叶 杆 部 分 (深蓝 色 );， 概率 为 7% 的 两 个 迭代 方程 计算 的 是 左右 两 片子 叶 ; 
而 概率 为 83% 的 迭代 方程 计算 整个 叶子 , 最 下 面 的 三 种 颜色 的 点 通过 此 公式 迭代 产生 上 面 所 有 
的 点 。 可 以 看 出 整 片 叶子 呈现 出 完美 的 自 相 似 特性 ， 任 意 取 其 中 的 一 片子 叶 ， 将 其 旋转 放大 之 
后 ， 和 整 片 叶子 完全 相同 。 


图 19-4 ”和 迭代 函数 系统 所 绘制 的 芯 类 植物 的 叶子 
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19.2.1 二 维 仿 射 变换 
上 一 节 介绍 的 4 个 坐标 变换 方程 的 一 般 形式 如 下 : 


x(n+1) = A* x(n) +B*y(n) +C 
y(n+1) = D * x(n) + E * y(n)+F 


这 种 变换 被 称 为 二 维 仿 射 变换 ， 它 是 将 二 a 
维 坐标 变换 到 其 他 二 维 坐标 的 线性 映射 ， 并 保 2 
留 直线 性 和 平行 性 。 即 直线 经 过 变换 之 后 仍然 “3 
是 一 条 直线 ， 原 来 平行 的 直线 ， 变 换 之 后 仍然 “> 
是 平行 的 。 这 种 变换 可 以 看 成 是 由 一 系列 平移 、 
缩放 、 旋 转变 换 构成 的 。 

为 了 直观 地 显示 仿 射 变换 ， 我 们 可 以 使 用 es 
平面 上 的 两 个 三 角形 来 表示 。 因 为 仿 射 变换 公 个 
式 中 有 6 个 未 知 数 一 A、B、C、D、E、F， 
此 一 共 需 要 三 组 点 来 决定 6 个 变换 方程 ， 正 好 是 两 个 三 角形 ， 如 图 19-5 所 示 。 

图 中 ， 从 红色 三 角形 的 每 个 顶点 变换 到 绿色 三 角形 的 对 应 项 点， 正好 能 够 决定 仿 射 变换 中 
的 6 个 参数 。 这 样 的 话 ， 我 们 可 以 使 用 N+1 个 三 角形 ， 决 定 Y 个 仿 射 变换 ， 其 中 每 个 变换 的 
参数 都 是 由 第 0 个 三 角形 和 其 他 的 三 角形 决定 的 。 第 0 个 三 角形 我 们 称 为 基础 三 角形 ， 其 他 的 
三 角形 称 为 变换 三 角形 。 

为 了 绘制 迭代 函数 系统 的 图 像 ， 我 们 还 需 
要 给 每 个 仿 射 变换 方程 指定 一 个 迭代 概率 参 * 
数 。 此 参数 也 可 以 使 用 三 角形 直观 地 表达 出 来 : of 
迭代 概率 和 变换 三 角形 的 面积 成 正比 ， 即 迭代 | 
概率 为 变换 三 角形 的 面积 除 以 所 有 变换 三 角形 | 7 
的 面积 之 和 。 LL 

如 图 19-6 所 示 ( 见 封 三 彩 插 )， 前 面 介绍 的 “Ne 
蕨 类 植物 的 分 形 图 案 的 迭代 方程 可 以 由 5 个 三 ”村 
角形 决定 ， 可 以 很 直观 地 看 出 紫色 小 三 角形 决 
定 了 叶子 的 茎 ， 而 两 个 蓝 色 的 三 角形 决定 了 左 
右 两 片子 叶 ; 绿色 的 三 角形 将 茎 和 两 片子 叶 往 
上 复制 ， 形 成 整 片 叶子 。 


19.2.2 ”迭代 函数 系统 设计 器 


按照 前 面 介 绍 的 三 角形 法 , 我 们 可 以 设计 一 个 用 于 和 迭代 函数 系统 的 设计 工具 。 用 户 通过 程 
序 界 面 绘制 或 修改 一 组 三 角形 ， 程 序 计算 这 组 三 角形 所 对 应 的 迭代 方程 组 的 系数 ， 并 实时 地 绘 


19-6 5 个 三 角形 的 仿 射 变换 方程 绘制 蕨 类 
植物 的 叶子 


制 迭 代 图 案 。 本 书 提供 了 matplotlib 和 Chaco 两 个 版 本 的 迭代 函数 设计 程序 ， 读 者 可 以 通过 分 
析 它 们 的 源 程序 来 了 解 如 何 制作 交互 式 绘图 程序 。 图 19-7 是 使 用 matplotlib 制作 的 界面 截图 ( 见 
封 三 彩 插 )， 而 图 19-8 是 使 用 Chaco 制作 的 界面 截图 ( 见 封 三 彩 插 )。 


ifs_matplotlib.py 
人。 使 用 matplotlib 制作 的 迭代 函数 系统 设计 工具 


有 ifs_chaco.py 
”使 用 Chaco 制作 的 迭代 函数 系统 设计 工具 


19-7 使 用 matplotlib 制作 的 迭代 函数 系统 分 形 图 案 图 19-8 使 用 Chaco 制作 的 迭代 函数 系统 分 形 图 案 
设计 界面 设计 界面 


这 两 个 程序 都 通过 调用 “ 帮 librarypy” 模 块 中 的 函数 来 完成 函数 的 迭代 计算 。 


ifs library.py 
a 和 迭代 函数 系统 的 计算 模块 


通过 两 个 三 角形 求解 仿 射 变换 方程 的 系数 ， 相 当 于 求 6 元 线性 方程 组 的 解 ， 这 个 计算 通过 
solve_eq0 函 数 完成 ， 它 先 计算 出 线性 方程 组 的 矩阵 ac 和 2， 然后 调用 NumPy 的 linalg.solve0 对 
线性 方程 组 a x XX=b 求解 : 


def solve eq(triangle1, triangle2): 
解 方程 ,从 trianglel 变换 到 triangle2 的 变换 系数 
trianglel、triangle2 是 二 维 数组 : 
x9,y9 
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x1,y1l 

x2,y2 
x0,y9 = trianglel[6] 
xl,y1 = trianglel[1] 
x2,y2 = triangle1[2] 


a = np.zeros((6,6)，dtype=np.float) 
b = triangle2.reshape(-1) 

a[6， 6:3] = xe,y9,1 

a[1，3:6] = x@,y8,1 

a[2, 0:3] = xl,yl,1 

a[3，3:6] = x1,y1,1 

a[4, 0:3] = x2,y2,1 

a[5, 3:6] = x2,y2,1 


c= np.linalg.solve(a, b) 


c.shape = (2,3) 
return c 


我 们 使 用 三 角形 的 面积 计算 每 个 仿 射 变换 方程 的 迭代 概率 ， 面 积 通过 triangle_area0 计 算 ， 
它 使 用 NumPy 的 cross0 来 计算 三 角形 两 个 边 的 矢量 的 又 积 : 


def triangle area(triangle): 


计算 三 角形 的 面积 


A, B, C = triangle 

AB = A-B 

AC = A-C 

return np.abs(np.cross(AB,AC))/2.6 


在 两 个 界面 程序 中 ， 都 使 用 定时 器 周期 性 地 调用 进行 迭代 计算 的 函数 。 由 于 定时 器 所 调用 
的 函数 在 界面 线程 中 运行 ， 如 果 它 的 处 理 时间 过 长 ， 将 会 影响 界面 的 响应 。 因 此 迭代 函数 每 次 
只 计算 ITER_COUNT 个 点 。 此 外 ， 如 果 计算 的 总 点 数 过 多 ， 会 影响 显示 速度 ， 因 此 最 多 只 调 
用 ITER_TIMES 次 和 迭代 函数 。 这 两 个 参数 可 以 在 程序 的 开头 找到 , 请 读者 根据 自己 计算 机 的 运 
算 速度 进行 修改 ， 下 面 是 “ifs_chaco.py” 中 的 默认 设置 : 


ITER_COUNT = 2868 # 一 次 IFS 迭代 的 点 数 
ITER_TIMES = 28  # 总 共 调用 IFs 的 次 数 


19.3 工 -System 分 形 


前 面 绘制 的 分 形 图 案 都 是 使 用 数学 函数 迭代 产生 的 ， 而 L-System 分 形 则 是 采用 符号 迭代 
产生 的 。 首 先 定义 如 下 几 个 有 含义 的 符号 : 

e F: 向 前 走 固定 单位 。 

。 +: 正方 向 旋转 固定 单位 。 

e -: 负 方 向 旋转 固定 单位 。 

使 用 这 三 个 符号 ， 我 们 很 容易 描述 图 19-9( 左 上 ) 中 由 4 条 线段 构成 的 图 案 : 


F+F--F+F 
如 果 将 此 符号 串 中 的 所 有 下 都 蔡 换 为 Ft+F--Ft+F， 就 能 得 到 如 下 的 新 字符 串 : 
F+F--F+F+F+F--F+F--F+F--F+F+F+F--F+F 


如 此 蔡 换 迭代 下 去 ， 并 根据 字符 串 进行 绘图 (符号 + 和 -分 别 表示 正 负 旋转 60” )， 可 得 到 如 
图 19-9 所 示 的 分 形 图 案 : 


Fe 
Re 


19-9 ”使 用 F+F-F+F 进行 迭代 的 分 形 图 案 


除了 “F”、“+”、“-” 之 外 ， 我 们 再 定义 如 下 几 个 符号 : 

。 f: 向 前 走 固定 单位 ， 它 和 下 的 效果 相同 ， 但 可 以 用 它 定义 不 同 的 迭代 公式 。 

。 [: 将 当前 的 位 置 压 入 堆栈 。 

。 ]: 从 堆栈 中 读 取 坐标 ， 修 改 当前 位 置 。 

。 S: 初始 迭代 符号 ， 所 有 的 迭代 从 此 符号 开始 。 

所 有 的 符号 (包括 上 面 未 定义 的 ) 都 可 以 用 来 定义 迭代 ， 通 过 引入 堆栈 ， 我 们 能 描述 带 分 又 
的 图 案 。 例 如 下 面 的 符号 欠 代 能 够 绘制 出 一 棵 植物 : 


SEX 
X -> F-[[X]+x]+F[+FX]-X 
F -> FF 


我 们 用 一 个 字典 定义 所 有 的 迭代 公式 和 其 他 的 一 些 绘图 信息 : 
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{ 
YX F=[[X]X]EIEFX]-X "FE" FE" “Ss "Xs 
"direct”:-45 
"angle":25, 
“Titer” :b> 
“title": "Plant” 
} 


其 中 : direct 是 绘图 的 初始 角度 ， 通 过 指定 不 同 的 值 可 以 旋转 整个 图 案 ，angle 是 符号 “+” 


和 “-” 的 旋转 角度 ， 不 同 的 值 能 产生 完全 不 同 的 图 案 ，iter 是 迭代 次 数 。 
下 面 的 程序 实现 L-System 的 迭代 工作 ， 并 计算 每 段 线段 的 坐标 。 


更 1 system py 


绘制 L-System 分 形 图 案 


class L_System(object): 
def _init_(self, rule): 
info = rule['S'] 


for 


i in range(rule['iter']): 
ninfo = [] 
for c in info: 
if c in rule: 
ninfo.append(rule[c]) 
else: 
ninfo.append(c) 
info = "".join(ninfo) 


self.rule = rule 
self.info = info 


def get 


d= 
a = 


Le 


lines(self): 
self.rule['direct'] 
self.rule['angle'] 
(8.0, 0.0) 

1.9 


lines = [] 
stack = [] 


for 


c in self.info: 

人 
r=d*pi/ 180 
t = p[8] + l*cos(r), p[1] + 1l*sin(r) 
lines.append(((p[9], p[1]), (t[e], t[1]))) 
p=t 


elif Cc == "+": 


d+=a 
Cl = 
d -=a 
elif c = "[": 
stack.append((p,d)) 
elif c == "]": 


p, d= stack[-1] 
del stack[-1] 
return lines 


下 面 的 draw0 完 成 绘图 工作 : 


from matplotlib import collections 

def draw(ax, rule, iter=None): 
if iter!=None: 

rule["iter"] = iter 

lines = L_System(rule).get lines() © 
linecollections = collections.LineCollection(lines) @ 
ax.add_collection(linecollections, autolim=True) © 
ax.axis("equal") 
ax.set _axis off() 
ax.set xlim(ax.dataLim.xmin, ax.datalLim.xmax) 
ax.invert_yaxis() 


Qeget_lines0 返 回 每 个 线段 的 坐标 。@ 创 建 一 个 表示 所 有 线段 集合 的 LineCollection 对 象 ， 
目 并 调用 Axes 对 象 ax 的 add_collection0 将 此 线段 集合 添加 到 ax.collections 列表 中 。 这 样 能 一 
次 添加 多 条 线段 ， 提 高 绘图 速度 。 图 19-10 是 程序 绘制 的 几 种 L-System 分 形 图 案 。 


~ 


19-10 几 种 L-System 分 形 图 案 
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19.4 分 形 山 脉 


前 面 介绍 的 分 形 图 案 都 是 严格 按照 迭代 公式 计算 出 来 的 ， 然 而 自然 界 中 的 山川 、 云 彩 、 树 
木 等 都 不 是 精确 的 自 相似 图 形 ， 而 是 统计 意义 上 的 自 相似 图 形 。 本 节 将 介绍 几 种 经 典 的 随机 山 
脉 地 形 的 生成 算法 ， 以 及 如 何 用 Python 快速 实现 这 些 算法 。 


19.4.1 一 维 中 点 移 位 法 


让 我 们 从 绘制 一 条 分 形 曲线 开始 。 使 用 中 点 位 移 算法 (midpoint displacement)， 能 够 有 效 地 
模拟 山脉 或 海岸 线 的 分 形 形 状 ， 算 法 如 下 : 

(1) 首先 在 X 轴 上 取 两 个 初始 点 A 和 B。 

(2) 找到 AB 两 点 的 中 点 ， 并 在 立轴 方向 上 进行 随机 移 位 ， 移 位 后 的 点 为 C。 

(G3) 对 于 线段 AC 和 BC 进行 与 步骤 (2) 相 同 的 操作 。 

每 次 迭代 时 ， 随 机 移 位 的 最 大 幅度 都 成 比例 地 衰减 。 和 迭代 足够 多 次 之 后 ， 将 得 到 的 点 连接 
起 来 ， 就 得 到 了 一 条 随机 的 分 形 曲线 。 

下 面 是 实现 此 算法 的 源 程序 ， 程 序 绘制 的 山脉 曲线 如 图 19-11 所 示 ( 见 封 三 彩 插 )。 


a firactal hilllD py 
使 用 中 点 移 位 法 绘制 一 维 分 形 山脉 


def hillld(n，d): 


绘制 山脉 曲线 ，2**n+1 为 曲线 在 X 轴 上 的 长 度 ，d 为 衰减 系数 


a = Np.zeros(2**n+1) © 
scale = 1.6 
for i in xrange(n, 9, -1): @ 
s = 2**(i-1) © 
S2 = 2*s 
tmp = a[::s2] 
a[s::s2] += (tmp[:-1] + tmp[1:]) * 6.5 @ 
a[s::s2] += np.random.normal(size=len(tmp)-1，scale=scale) @ 


scale *= d @ 
return a 
if _name _ == ” main “": 


import matplotlib.pyplot as plt 

plt.figure(figsize=(8,4)) 

for i, d in enumerate([8.4, 8.5, 0.6]): 
np.random.seed(8) @ 


a = hill1d(9, d) 
plt.plot(a, label="d=%s" % d, linewidth=3-i) 
plt.xlim((8,len(a))) 
plt.legend() 
plt.show() 


1.8 
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图 19-11 一 维 分 形 山脉 曲线 ， 豪 减 值 越 小 ， 最 大 幅度 的 衰减 越 快 ， 曲 线 越 平滑 


hillld0 计 算 一 维 分 形 山脉 曲线 。@@ 为 了 运算 方便 ， 我 们 用 一 个 一 维 数组 a 保存 曲线 上 每 点 
的 高 度 ， 而 曲线 上 每 点 的 X 轴 坐标 则 由 数组 的 下 标 决定 。 这 要 求 每 次 计算 中 点 时 得 到 的 X 轴 
坐标 必须 是 整数 。 显 然 ， 当 数组 长 度 为 2*+1 时 满足 这 个 要 求 。 

@ 由 于 数组 a 的 长 度 为 2+1， 因 此 需要 循环 n 次 才能 够 计算 到 数组 上 所 有 的 点 。 每 次 循环 
时 ， 都 要 对 数组 中 的 某 些 点 计算 中 值 ， 例 如 对 于 n=8， 即 数组 长 度 为 257 时 ， 循 环 变量 i 和 数 
组 中 需要 计算 中 点 的 下 标 如 表 19-1 所 示 。 


表 19-1 数组 长 度 为 257 时 需要 计算 中 点 的 下 标 
需要 计算 中 点 的 数组 下 标 
128 
64.192 
32.96.160.224 
16. 48. 80. 112. 144. 176. 208. 240 


卓 数 组 中 每 次 迭代 要 计算 的 中 点 下 标 是 一 个 等 差 数列 ， 其 起 始 下 标 为 s=2”"， 间 隔 为 s=2 。 
@ 而 每 个 中 点 都 由 其 左右 下 标 相差 s 的 两 个 数值 计算 。@ 给 每 个 中 点 一 定 的 随机 位 移 。 这 里 使 
用 nomal0 产 生 一 个 正 态 分 布 的 随机 数组 ， 其 期 望 值 为 0， 标 准 偏差 为 scale。 这 样 产生 的 山脉 
曲线 就 会 既 有 山峰 也 有 山谷 。@ 最 后 将 下 一 次 迭代 的 标准 偏差 乘 上 系数 d，d 越 小 ， 标 准 偏差 
的 衰减 越 快 。 

接 下 来 绘制 d 为 0.4、0.5、0.6 时 的 山脉 曲线 。@ 这 里 为 了 对 不 同 的 衰减 系数 所 产生 的 曲线 
进行 比较 ， 需 要 保证 每 次 都 使 用 相同 的 随机 数 来 计算 曲线 ， 因 此 使 用 seed0 指 定 生成 随机 数 的 
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种 子 。 在 真正 需要 随机 产生 曲线 时 ， 请 将 此 句 注释 掉 。 
19.4.2 二 维 中 点 移 位 法 


中 点 移 位 法 很 容易 扩展 到 二 维 ， 我 们 可 以 使 用 它 计 算 山脉 曲面 ， 算 法 如 图 19-12 所 示 。 左 
图 中 ， 从 白色 圆 点 的 值 ( 值 为 0、2、4、8 的 4 个 点 ) 计 算 它们 的 5 个 用 灰色 圆 点 表示 的 中 值 点 。 
边 上 4 个 中 值 点 的 计算 和 一 维 的 情况 相同 ， 而 正中 间 的 中 值 则 是 4 个 角 上 的 值 的 平均 值 。 

右 图 以 计算 5*5 的 方 格 为 例 ， 演 示 了 每 步 迭 代 时 所 计算 的 点 。 方 格 中 的 数字 表示 计算 此 点 
的 值 的 迭代 次 数 。 初 期 情况 下 4 个 角 上 的 点 已 知 ， 标 记 它 们 的 迭代 次 数 为 0。 根 据 左 图 的 中 值 
计算 方式 , 计算 出 标记 为 1 的 5 个 方 格 的 值 。 然后 对 于 由 办 代 0 和 迭代 1 的 点 组 成 的 4 个 方块 ， 
再 次 进行 中 值 计 算 ， 计 算出 所 有 标记 为 2 的 16 个 方 格 的 值 。 


图 19-12 ”二 维 中 点 移 位 法 示意 图 


完整 的 计算 程序 如 下 ， 程 序 的 显示 效果 如 图 19-13 所 示 ( 见 封 三 彩 插 )。 


A fractal_hill2D.py 
写 。 二 维 中 点 移 位 法 绘制 山脉 曲面 


程序 的 算法 和 一 维 的 情况 类 似 ， 这 里 就 不 多 解释 了 。@ 在 计算 出 表示 山脉 曲面 的 二 维 数组 
a 之 后 , 调用 np.ptp0 得 到 数组 a 中 最 大 值 和 最 小 值 之 间 的 差 , 并 将 值 放 大 到 数组 形状 的 0.5 倍 ， 
以 便 调用 mlab.surf0 绘 制 曲面 。@ 使 用 SciPy 的 多 维 数组 卷 积 函 数 convolve0 对 二 维 数组 a 进行 
平滑 处 理 。 


import numpy as np 
import pylab as pl 
from numpy.random import normal 


def hill2d(n, d): 
绘制 山脉 曲面 ， 曲 面 是 一 个 (2**n + 1)*(2**n + 1) 的 图 像 
d 为 衰减 系数 


Size = 2**n + 1 
scale = 1.6 
a = np.zeros((size, size)) 


for i in xrange(n, 8, -1): 
有 二 24( 
2 52 
tmp = a[::s2,::s2] 
tmp1 = (tmp[1:,:] + tmp[:-1,:])*6.5 
tmp2 = (tmp[:,1:] + tmp[:，,:-1])*6.5 
tmp3 = (tmp1[:,1:] + tmpl[:，,:-1])*9.5 
a[s::s2, ::s2] = tmpl + normal(9,scale,tmp1.shape) 
a[::s2, s::s2] = tmp2 + normal(9,scale,tmp2.shape) 
a[s::s2,s::S2] = tmp3 + normal(9,scale,tmp3.shape) 
Scale *=d 


return a 


if _name == "_ main_": 

from enthought.mayavi import mlab 

from scipy.ndimage.filters import convolve 
a = hill2d(8, 0.5) 

a/= np.ptp(a) / (8.5*2++8) © 

a = convolve(a, np.ones((3,3))/9) @ 
mlab.surf(a) 


mlab.show() 


图 19-13 二 维 中 点 移 位 法 绘制 山脉 曲面 


19.4.3 ”菱形 方形 算法 


通过 上 面 的 介绍 我 们 知道 ， 每 次 迭代 都 是 通过 正方 形 4 个 角 上 的 点 的 值 ， 计 算 边 上 4 点 和 
中 心 点 的 值 ， 这 是 最 简单 的 一 种 方法 。 但 如 果 读 者 放大 它 所 生成 的 曲面 ， 就 会 发 现 曲 面 上 有 一 
些 大 大 小 小 的 正方 形 痕迹 。 菱形 方形 算法 (diamond-square algorithm) 通 过 将 两 种 中 值 计算 方法 交 
替 使 用 ， 有 效 地 消除 了 这 种 正方 形 痕迹 ， 算 法 如 图 19-14 所 示 。 
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0 LO ES 
a £ y 个 y 
针 鸭 < 本 > 四 

RS 个 y 个 
2 DO sa pO 


图 19-14 菱形 方形 算法 


首先 如 左 图 所 示 , 通过 正方 形 的 4 个 角 点 计算 位 于 它们 中 心 的 点 的 平均 值 。 然 后 如 中 图 所 
示 ， 通 过 菱形 的 4 个 角 点 计算 位 于 它们 中 心 的 点 的 平均 值 。 图 中 没有 一 个 完整 的 菱形 ， 而 是 4 
个 半边 萎 形 。 我 们 也 可 以 把 正方 形 平均 看 做 左上 、 右上、 左下 和 右 下 4 个 方向 上 的 点 的 平均 值 ， 
而 把 萎 形 平均 看 做 上 、 下 、 左 、 右 4 个 方向 上 的 点 的 平均 值 。 右 图 显示 了 采用 萎 形 正方 形 计算 
5*5 的 数组 时 的 运算 顺序 。 从 标记 为 0 的 方 格 开始 ， 以 方形 平均 计算 标记 为 1s 的 方 格 值 ， 然 后 
以 萎 形 平均 计算 标记 为 1d 的 4 个 方 格 的 值 。 接 下 来 重复 上 面 的 步 又， 方形 平均 计算 2s 方 格 ， 
最 后 萎 形 平均 计算 2d 方 格 。 

使 用 菱形 方形 算法 绘制 山脉 曲面 的 程序 如 下 ，hill2d_ds0 是 计算 曲面 数组 的 函数 。 


fractal hill2D ds.py 
六 一 用 凌 形 方形 算法 绘制 山脉 曲面 


def hill2d ds(n, d): 
Size = 2**n+1 
scale = 1.6 
a = Np.zeros((size, size)) 


for i in xrange(n, 0, -1): 
s = 2**(i-1) 
S2 = 2*s 
# 方形 平均 
t= al::s2 52] 
Tt2 = (LA tl tl ts =D 
tmp = a[s::s2,s::s2] 
tmp[...] = t2 + normal(8, scale, tmp.shape) 


buf = a[::s2, ::s2] 


# 萎 形 平均 分 两 步 ， 分 别 计算 水 平和 垂直 方向 上 的 点 


Es al:s2,5s2] 
3 | 
t[:-1] += tmp 
t[1:] += tmp 
t[[8,-1],:] /= 3 # 边 上 是 3 个 值 的 平均 
t[1:-1,:] /= 4 # 中 间 是 4 个 值 的 平均 
t[...] += np.random.normal(96，scale，t.shape) 
Esals::s2:52] 
| 
t[:,:-1] += tmp 
t[:,1:] += tmp 
t[:,[8,-1]] /= 3 
t[:,1:-1] /= 4 
t[...] += np.random.normal(0, scale, t.shape) 
Scale *#= d 
return a 


观察 图 19-14( 右 ) 中 标记 为 2d 的 方 格 ,我 们 发 现 姜 形 平均 对 应 的 方 格 无 法 用 一 个 数组 表示 ， 
因此 程序 中 将 它们 分 为 水 平和 垂直 方向 上 的 两 个 数组 分 别 计算 。 程 序 中 大 量 使 用 数组 切片 ， 使 
得 许多 计算 在 C 语言 级 别 进行 ， 从 而 提高 程序 的 运算 速度 。 如 果 读 者 觉得 较 难 理解 ， 可 以 修改 
。 注释 掉 随机 数 部 分 ， 并 在 迭代 之 前 将 数组 4 个 角 上 的 元 素 赋值 为 不 为 零 的 数值 。 
。 使 用 较 小 的 数组 ， 并 且 输 出 每 次 赋值 之 后 数组 a 的 值 。 通 过 观察 数组 a 的 变化 ,可 以 
帮助 理解 程序 和 萎 形 方形 算法 。 
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